| Microsoft DirectX 8.1 (C++) |
This topic applies to Windows XP Home Edition and Windows XP Professional only.
The get_Item method retrieves the MetaProperty object at the specified index, or the object that matches the specified MetaPropertySet and MetaPropertyType objects.
Syntax
HRESULT get_Item(
VARIANT varIndex,
IMetaProperty** ppprop
);
Parameters
varIndex
[in] Specifies the item to be retrieved. This must be a VARIANT of subtype VT_I4 containing an index in the range from 0 to the value returned by IChannelLineups::get_Count minus 1, or a VARIANT of subtype VT_BSTR containing the names of the MetaPropertySet and MetaPropertyType objects. See Remarks.
ppprop
[out] Address of a variable to receive a pointer to the IMetaProperty interface of the retrieved object.
Return Values
The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.
| Return code | Description |
| S_OK | The method succeeded. |
| E_INVALIDARG | varIndex is not a valid type, or does not specify an existing object. |
| E_POINTER | Data cannot be read from or written to a supplied address. |
Remarks
If the varIndex parameter contains a string, it is interpreted in the same way as the bstrName parameter of IMetaPropertySets::get_Lookup; that is, it must contain the name of a MetaPropertySet and the name of a MetaPropertyType object, separated by a period. The get_Item method then retrieves the MetaProperty that matches the MetaPropertyType. This is equivalent to retrieving a pointer to the IMetaPropertyType interface by using IMetaPropertySets::get_Lookup, retrieving the active GuideDataProvider by using IGuideStore::get_ActiveGuideDataProvider, and passing those pointers to IMetaProperties::get_ItemWithTypeProviderLang.
See Also