Microsoft DirectX 8.1 (C++)

IMetaPropertyTypes::get_ItemWithName

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

The get_ItemWithName method retrieves a MetaPropertyType object by the object's name.

Syntax

HRESULT get_ItemWithName(
  BSTR  bstrName,
  IMetaPropertyType**  ppproptype
);

Parameters

bstrName

[in]  Specifies the name of the MetaPropertyType object.

ppproptype

[out]  Address of a variable to receive a pointer to the IMetaPropertyType 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 A matching object was not found.
E_POINTER Data cannot be read from or written to a supplied address.

Remarks

The MetaPropertyTypes collection is not organized by bstrName but only by the MetaPropertyType object's unique identifier. This method searches the collection sequentially for the bstrName and is, therefore, slower than the IMetaPropertyTypes::get_ItemWithID method.

See Also