PlaylistCollection.importPlaylist method

[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 importPlaylist method adds a static playlist to the library.

Syntax

retVal = PlaylistCollection.importPlaylist(
  playlist
)

Parameters

playlist [in]

Playlist object to be added.

Return value

This method returns the Playlist object that was added.

Remarks

Playlists that do not contain any media items cannot be added to the library by using this method. To create an empty playlist in the library, use the newPlaylist method. You can then fill the resulting playlist with media items by using Playlist.appendItem or Playlist.insertItem.

If you pass this method an auto playlist, the query is executed once and the result is added to the library as a static playlist. To add an auto playlist to the library and preserve its automatic behavior, use MediaCollection.add. For more information, see Static and Auto Playlists.

To use this method, full access to the library is required. For more information, see Library Access.

Requirements

Requirement Value
Version
Windows Media Player version 7.0 or later.
DLL
Wmp.dll

See also

Managing Playlists

MediaCollection Object

MediaCollection.add

Playlist.appendItem

Playlist.insertItem

PlaylistCollection Object

PlaylistCollection.newPlaylist

PlaylistCollection.remove

Settings.mediaAccessRights

Settings.requestMediaAccessRights