Windows Media Player 11 SDK IWMPMedia::getItemInfo 

IWMPMedia::getItemInfo

The getItemInfo method retrieves the value of the specified attribute for the media item.

Syntax

Parameters

bstrItemName

[in]  BSTR containing the item name.

pbstrVal

[out]  Pointer to a BSTR containing the returned value.

Return Values

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Remarks

This method retrieves the metadata for an individual media item or a media item that is part of a playlist.

The get_attributeCount method retrieves the number of attribute names available for a given media item. Index numbers can then be used with the getAttributeName method to determine the name of each available attribute. Individual attribute names can be passed to getItemInfo.

To retrieve attributes with multiple values and attributes with complex values, use the getItemInfoByType method.

The set of attributes available from sources other than the local library (remote libraries, portable devices, or CDs is defined by the other sources.

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

Windows Media Player 10 Mobile: Attributes for a media item are available only during playback unless they are retrieved from the item through the media collection.

Requirements

Version: Windows Media Player 9 Series or later.

Header: Include wmp.h.

Library: Use wmp.dll.

See Also

• Attribute Reference
• IWMPMedia Interface
• IWMPMedia::get_attributeCount
• IWMPMedia::getAttributeName
• IWMPMedia::setItemInfo
• IWMPMedia3::getItemInfoByType