IWMDMStorage4 ::GetRightsWithProgress, méthode (mswmdm.h)

La méthode GetRightsWithProgress récupère les informations de droits de l’objet de stockage, en fournissant un mécanisme de rappel pour surveiller la progression.

Syntaxe

HRESULT GetRightsWithProgress(
  [in]  IWMDMProgress3 *pIProgressCallback,
  [out] PWMDMRIGHTS    *ppRights,
  [out] UINT           *pnRightsCount
);

Paramètres

[in] pIProgressCallback

Pointeur facultatif vers une interface IWMDMProgress3 à utiliser par Windows Media Gestionnaire de périphériques pour signaler la progression à l’application.

[out] ppRights

Pointeur vers un tableau de structures WMDMRIGHTS qui contiennent les informations sur les droits d’objet de stockage. La mémoire de ce tableau est allouée par Windows Media Gestionnaire de périphériques. Lorsque l’application appelante a terminé d’accéder à ce tableau, la mémoire doit être libérée à l’aide de CoTaskMemFree.

[out] pnRightsCount

Pointeur vers le nombre de structures WMDMRIGHTS dans le tableau ppRights .

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 suivantes de codes d’erreur :

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

Remarques

Les droits d’objet décrivent les autorisations d’utilisation pour le contenu multimédia numérique. 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.

La récupération des droits à partir d’un fichier sous licence peut parfois être une demande longue ; cette fonction permet d’effectuer une demande de droits de manière asynchrone.

Le fournisseur de contenu sécurisé peut générer des notifications d’événements sur le rappel pIProgressCallback en plus des notifications de progression. Par exemple, l’acquisition d’une horloge sécurisée, l’initialisation de drm, etc. Ces événements sont décrits dans IWMDMProgress3 ::P rogress3.

Cette méthode est identique à IWMDMStorage ::GetRights, sauf qu’elle retourne la progression et ne fournit pas de MAC pour la vérification des paramètres.

Configuration requise

Voir aussi

IWMDMStorage4, interface