Player.newPlaylist 方法

[與此頁面相關聯的功能Windows 媒體播放機 SDK是舊版功能。 它已被 MediaPlayer 取代。 MediaPlayer已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用MediaPlayer，而不是Windows 媒體播放機 SDK。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼，以使用新的 API。]

newPlaylist方法會建立新的Playlist物件。

語法

retVal = Player.newPlaylist(
  name,
  URL
)

參數

name [in]

包含 新播放清單名稱的字串。

URL [in]

包含 Windows Media 中繼檔播放清單 URL 的字串，用來建立 Playlist 物件。

傳回值

這個方法會傳回 Playlist 物件。

備註

如果 URL 參數設定為 null 或 「」 (空字串) ，則會建立空的 Playlist 物件。 如果 name 參數設定為 「」，則會使用中繼檔內的名稱。

使用此方法建立的新播放清單不會新增至文件庫。 若要將新的播放清單新增至文件庫，請使用 PlaylistCollection。importPlaylist 或 PlaylistCollection。newPlaylist。 播放清單名稱中的任何前置或尾端空格都會在新增至文件庫時自動移除。

因為程式庫允許多個具有相同名稱的播放清單，所以您可能想要先檢查具有指定名稱的播放清單是否存在，然後再新增一個新的播放清單。

規格需求

需求	值
版本	Windows Media Player  9  系列或更新的版本。
DLL	Wmp.dll

另請參閱

Player 物件

PlaylistCollection.importPlaylist

PlaylistCollection.newPlaylist

Windows Media 中繼檔