IWMPMediaCollection2::getByAttributeAndMediaType method (wmp.h)

[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The getByAttributeAndMediaType method retrieves a pointer to an IWMPPlaylist interface. This interface represents a playlist that contains media items that have a specified attribute and media type.

Syntax

HRESULT getByAttributeAndMediaType(
  [in]  BSTR         bstrAttribute,
  [in]  BSTR         bstrValue,
  [in]  BSTR         bstrMediaType,
  [out] IWMPPlaylist **ppMediaItems
);

Parameters

[in] bstrAttribute

String that contains the specified attribute.

[in] bstrValue

String that contains the specified value for the attribute that is specified in bstrAttribute.

[in] bstrMediaType

String that contains the specified media type.

[out] ppMediaItems

Address of a variable that receives a pointer to an IWMPPlaylist interface for the retrieved playlist.

Return value

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

Windows Media Player 10 Mobile: This method is not supported.

Requirements

Requirement	Value
Minimum supported client	Windows Media Player 11.
Target Platform	Windows
Header	wmp.h
DLL	Wmp.dll

See also

IWMPMediaCollection2 Interface

IWMPPlaylist Interface