IWMDRMLicenseManagement :: RestoreLicenses, méthode

La méthode RestoreLicenses restaure les licences à partir d’une sauvegarde de licence créée en appelant la méthode BackupLicenses .

Syntaxe

HRESULT RestoreLicenses(
  [in]  BSTR     bstrBackupDirectory,
  [in]  DWORD    dwFlags,
  [out] IUnknown **ppunkCancelationCookie
);

Paramètres

bstrBackupDirectory [ dans]

Chemin d’accès UNC de l’emplacement à partir duquel les licences seront restaurées.

dwFlags [ dans]

Indicateurs spécifiant les options de restauration à utiliser. Le seul indicateur actuellement pris en charge est l' _ _ élément de restauration WMDRM, qui configure la méthode pour effectuer l’individualisation dans le cadre de la restauration, si nécessaire.

ppunkCancelationCookie [ à]

Pointeur qui reçoit un pointeur vers l’interface IUnknown d’un objet qui identifie cet appel asynchrone. Ce pointeur d’interface peut être utilisé pour annuler l’appel asynchrone en appelant la méthode IWMDRMEventGenerator :: CancelAsyncOperation .

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour Description
_OK
S_OK

Remarques

Cette méthode s’exécute de façon asynchrone. Elle retourne immédiatement après l’appel de, puis génère une série d’événements MEWMDRMLicenseRestoreProgress suivie d’un événement MEWMDRMLicenseRestoreCompleted lorsque le traitement est terminé. La valeur de chacun des événements MEWMDRMLicenseRestoreProgress obtenus en appelant IMFMediaEvent :: GetValue est un pointeur IUnknown . Vous pouvez appeler la méthode QueryInterface de l’interface IUnknown Récupérée pour récupérer une instance de l’interface IWMDRMLicenseBackupRestoreStatus .

pour plus d’informations sur l’utilisation des méthodes asynchrones des api étendues du Client Media DRM Windows, consultez utilisation du modèle d’événement Media Foundation.

La sauvegarde peut être à partir de l’ordinateur local ou d’un autre ordinateur.

Configuration requise

Condition requise Valeur
En-tête
Wmdrmsdk. h
Bibliothèque
Wmdrmsdk. lib

Voir aussi

Interface IWMDRMLicenseManagement