Microsoft DirectX 8.1 (C++)

IMetaPropertySets::get_Item

This topic applies to Windows XP Home Edition and Windows XP Professional only.

The get_Item method retrieves a MetaPropertySet object by index.

Syntax

HRESULT get_Item(
  VARIANT  varIndex,
  IMetaPropertySet**  pppropset
);

Parameters

varIndex

[in]  Specifies the index. The vt member of the VARIANT structure must have one of the following values.

Value Description
VT_BSTR The bstrVal member contains the name of the desired MetaPropertySet object.
VT_I4 The lVal member contains a number in the range from 0 to the value returned by IMetaPropertySets::get_Count minus 1.

pppropset

[out]  Address of a variable to receive the IMetaPropertySet interface pointer 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

Passing a string in varIndex is equivalent to calling IMetaPropertySets::get_ItemWithName.

See Also