External.libraryLocationID

[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.]

Note

This topic describes functionality designed for use by online stores. Use of this functionality outside the context of an online store is not supported.

The libraryLocationID property retrieves the identifier of the specific media item that is currently displayed in the Player's view.

window.external.libraryLocationID
      

Possible Values

This property is a read-only String.

Remarks

This property works in combination with the External.libraryLocationType property. For example, suppose libraryLocationType is equal to CPAlbumID and libraryLocationID is equal to 3. That means the current view in Windows Media Player is showing the album that has an ID of 3. For more information about how Windows Media Player characterizes views of online store content, see Location and Selected Item.

Certain views in Windows Media Player are associated with a particular media item. For example, if the current view represents an individual album, libraryLocationType is equal to CPAlbumID, and libraryLocationID is the ID of the album. Other views are not associated with any particular media item. For example, if the current view represents all albums, libraryLocationType is equal to AllCPAlbumIDs, but there is no meaningful value that can be assigned to libraryLocationID. In cases where the libraryLocationID property has no meaningful value, it is equal to the empty string.

Requirements

Requirement	Value
Version	Windows Media Player 11.
DLL	Wmp.dll

See also

External Object for Type 1 Online Stores

External.libraryLocationType

Location and Selected Item