Share via

Windows Media Player 11 SDK IWMPMediaCollection::getMediaAtom 

  • Article

Windows Media Player SDK banner art

Previous Next

IWMPMediaCollection::getMediaAtom

The getMediaAtom method retrieves the index at which a given attribute resides within the set of available attributes.

Syntax

Parameters

bstrItemName

[in]  String containing the name of the item for which the index should be retrieved.

plAtom

[out]  Pointer to a long containing the index.

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.

Remarks

The index number retrieved with this method can be passed to the IWMPMedia::getItemInfoByAtom to access attribute values. This technique is generally more efficient when working with large playlists than accessing an attribute value by name through IWMPMedia::getItemInfo.

Before calling this method, you must have read access to the library. For more information, see Library Access.

Requirements

Version: Windows Media Player 9 Series or later.

Header: Include wmp.h.

Library: Use wmp.dll.

See Also

Previous Next