Microsoft DirectX 8.0 (C++) |
Retrieves information about an object in the container.
HRESULT EnumObject( REFGUID rguidClass, DWORD dwIndex, LPDMUS_OBJECTDESC pDesc, WCHAR* pwszAlias );
If the method succeeds, one of the following success codes is returned:
S_OK | The object was enumerated. |
S_FALSE | There is no object with an index of dwIndex. |
DMUS_S_STRING_TRUNCATED | The alias is longer than MAX_PATH |
DMUS_S_GARBAGE_COLLECTED | See Garbage Collection. |
If the method fails, it can return E_POINTER.
You must initialize the dwSize member of the DMUS_OBJECTDESC structure before passing it to the method. Other members are ignored. You cannot reduce the scope of the enumeration by, for example, specifying a value in the wszName member. The description returned by the method can be used to retrieve the object by calling IDirectMusicLoader8::GetObject. For sample code, see Containers.
Header: Declared in dmusici.h.