IWMPLibraryServices::getLibraryByType method (wmp.h)

Article
4/26/2023

[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 getLibraryByType method retrieves a pointer to an IWMPLibrary interface that represents the library that has the specified type and index.

Syntax

HRESULT getLibraryByType(
  [in]  WMPLibraryType wmplt,
  [in]  long           lIndex,
  [out] IWMPLibrary    **ppIWMPLibrary
);

Parameters

[in] wmplt

WMPLibraryType enumeration value that specifies the type of library to retrieve.

[in] lIndex

A long containing the index of the library to retrieve.

[out] ppIWMPLibrary

Address of a variable that receives a pointer to the retrieved IWMPLibrary interface.

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

There is only one local library and disc libraries are available only on data CDs and DVDs that contain media content.

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

Partager via