Método PlaylistCollection.getByName

[La característica asociada a esta página, Reproductor multimedia de Windows SDK, es una característica heredada. Se ha reemplazado por MediaPlayer. MediaPlayer se ha optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer en lugar de Reproductor multimedia de Windows SDK, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El método getByName recupera un objeto PlaylistArray que contiene listas de reproducción con el nombre especificado, si existe alguno.

Sintaxis

retVal = PlaylistCollection.getByName(
  name
)

Parámetros

name [in]

Cadena que contiene el nombre de las listas de reproducción que se van a recuperar.

Valor devuelto

Este método devuelve un objeto PlaylistArray .

Observaciones

Use PlaylistArray. count para determinar si existe una lista de reproducción. Si count es cero, no existe una lista de reproducción.

Para usar este método, se requiere acceso de lectura a la biblioteca. Para obtener más información, vea Acceso a bibliotecas.

Ejemplos

En el siguiente ejemplo de JScript se usa playlistCollection. getByName para comprobar el objeto playlistCollection de una lista de reproducción denominada "ThreeList". Si existe la lista de reproducción "Threelist", getByName establece "ThreeList" como lista de reproducción actual. El objeto Player se creó con el identificador = "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);
}

Requisitos

Requisito	Value
Versión	Reproductor multimedia de Windows versión 7.0 o posterior.
Archivo DLL	Wmp.dll

Consulte también

PlaylistArray (objeto)

PlaylistArray.count

PlaylistCollection (objeto)

Settings.mediaAccessRights

Settings.requestMediaAccessRights