IWMPMedia::getItemInfo (Windows Embedded CE 6.0)
1/6/2010
The getItemInfo method retrieves the value of the specified attribute for the media item.
Syntax
HRESULT getItemInfo(
BSTR bstrItemName,
BSTR* pbstrVal
);
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.
| Return code | Description |
|---|---|
S_OK |
The method succeeded. |
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.
Attributes for a media item are available only during playback unless they are retrieved from the item through the media collection.