Settings.requestMediaAccessRights, méthode

[La fonctionnalité associée à cette page, Lecteur multimédia Windows SDK, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer. MediaPlayer a été optimisé pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer au lieu de Lecteur multimédia Windows SDK, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La méthode requestMediaAccessRights demande un niveau d’accès spécifié à la bibliothèque.

Syntaxe

bRetVal = Settings.requestMediaAccessRights(
  access
)

Paramètres

access [in]

Chaîne spécifiant le niveau de droits d’accès souhaité. Contient l'une des valeurs suivantes :

String	Description
aucun	Droits d’accès à l’élément actuel uniquement.
lire	Droits d’accès en lecture uniquement.
complet	Droits d’accès en lecture/écriture.

Valeur retournée

Cette méthode retourne une valeur booléenne indiquant si les droits d’accès demandés ont été accordés.

Notes

Une page web doit d’abord demander à l’utilisateur l’autorisation de lire des informations ou d’écrire des données dans la bibliothèque. L’appel de cette méthode invite l’utilisateur avec une boîte de dialogue qui demande le niveau d’autorisation spécifié. Cela signifie que certaines méthodes, propriétés et événements seront inaccessibles à partir du code si les droits d’accès appropriés n’ont pas été accordés. Le niveau de droits d’accès actuel peut être récupéré à l’aide de Paramètres. mediaAccessRights.

Lecteur multimédia Windows 10 Mobile : cette méthode retourne toujours true.

Configuration requise

Condition requise	Valeur
Version	Lecteur multimédia Windows série 9 ou ultérieure.
DLL	Wmp.dll

Voir aussi

Objet Settings

Settings.mediaAccessRights