Metodo PlaylistCollection.getByName

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stata sostituita da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer anziché Lettore multimediale Windows SDK, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il metodo getByName recupera un oggetto PlaylistArray contenente playlist con il nome specificato, se presente.

Sintassi

retVal = PlaylistCollection.getByName(
  name
)

Parametri

nome [in]

Stringa contenente il nome delle playlist da recuperare.

Valore restituito

Questo metodo restituisce un oggetto PlaylistArray .

Commenti

Usare PlaylistArray. conteggio per determinare se esiste una playlist. Se il conteggio è zero, una playlist non esiste.

Per usare questo metodo, è necessario accedere in lettura alla libreria. Per altre informazioni, vedere Accesso alla libreria.

Esempio

Nell'esempio JScript seguente viene usata playlistCollection. getByName per controllare l'oggetto playlistCollection per una playlist denominata "ThreeList". Se esiste la playlist "Threelist", getByName imposta "ThreeList" come playlist corrente. L'oggetto Player è stato creato con l'ID = "Player".

//Retrieve the count of the playlists named "ThreeList".
var Checkit = Player.playlistCollection.getByName("ThreeList").count;

//Since duplicate playlist names are allowed, the count returned
//will be either zero (no playlist) or greater than zero 
//(playlist exists).
if (Checkit > 0){ 
    
   //Retrieve a playlistArray object containing "ThreeList". Assume that
   //there is only one playlist with that name, and assign it to the 
   //current playlist.
   Player.currentPlaylist = Player.playlistCollection.getByName("ThreeList").item(0);
}

Requisiti

Requisito	Valore
Versione	Lettore multimediale Windows versione 7.0 o successiva.
DLL	Wmp.dll

Vedi anche

Oggetto PlaylistArray

PlaylistArray.count

Oggetto PlaylistCollection

Settings.mediaAccessRights

Settings.requestMediaAccessRights