Microsoft DirectX 8.1 (C++)

IObjects::get_ItemsRelatedToBy

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

The get_ItemsRelatedToBy method retrieves a collection of objects related to the specified object.

Syntax

HRESULT get_ItemsRelatedToBy(
  IUnknown*  pobj,
  IMetaPropertyType*  pproptype,
  IObjects**  ppobjs
);

Parameters

pobj

[in]  Specifies the IUnknown interface of the object to which the objects in the retrieved collection are related.

pproptype

[in]  Specifies the IMetaPropertyType interface of a MetaPropertyType object.

ppobjs

[out] Address of a variable to receive a pointer to the IObjects interface of the retrieved collection.

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_OUTOFMEMORY There is not sufficient memory to create the collection.
E_POINTER Data cannot be read from or written to a supplied address.

Remarks

This method is used by applications that extend the Guide Store by introducing new objects.

See Also