MÉTHODE IMDSPStorage ::GetRights (mswmdm.h)

Article
03/04/2024

La méthode GetRights récupère les informations de droits d’un objet.

Syntaxe

HRESULT GetRights(
  [out]     PWMDMRIGHTS *ppRights,
  [out]     UINT        *pnRightsCount,
  [in, out] BYTE [8]    abMac
);

Paramètres

[out] ppRights

Pointeur vers un tableau de structures WMDMRIGHTS qui contiennent les informations sur les droits d’objet de stockage. Ce paramètre est inclus dans le code d’authentification du message de sortie.

[out] pnRightsCount

Pointeur vers le nombre de structures WMDMRIGHTS dans le tableau ppRights . Ce paramètre est inclus dans le code d’authentification du message de sortie.

[in, out] abMac

Tableau de huit octets contenant le code d’authentification de message pour les données de paramètre de cette méthode. (WMDM_MAC_LENGTH est défini comme 8.)

Valeur retournée

Cette méthode retourne un code HRESULT. Toutes les méthodes d’interface dans Windows Media Gestionnaire de périphériques peuvent retourner l’une des classes de codes d’erreur suivantes :

Codes d’erreur COM standard
Codes d’erreur Windows convertis en valeurs HRESULT
Codes d’erreur Gestionnaire de périphériques Windows Media

Pour obtenir une liste complète des codes d’erreur possibles, consultez Codes d’erreur.

Remarques

Les droits d’objet décrivent les autorisations d’utilisation du contenu multimédia. Par exemple, la structure WMDMRIGHTS peut contenir des informations sur le nombre de fois où un fichier peut être lu et qui peut le lire.

Le tableau ppRights est alloué par cette méthode et doit être libéré par l’application à l’aide de CoTaskMemFree, une fonction Win32 standard.

Cette méthode est facultative. Pour plus d’informations, consultez Interfaces obligatoires et facultatives.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	mswmdm.h
Bibliothèque	Mssachlp.lib

Voir aussi

IMDSPStorage Interface

WMDMRIGHTS

Partager via