Partager via


Méthode IWMDRMLicenseManagement::BackupLicenses

[La fonctionnalité associée à cette page, le Kit de développement logiciel (SDK) Windows Media Format 11, est une fonctionnalité héritée. Il a été remplacé par lecteur source et enregistreur récepteur. Le lecteur source et l’enregistreur récepteur ont été optimisés pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise le lecteur source et l’enregistreur récepteur au lieu du Kit de développement logiciel (SDK) Windows Media Format 11, 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 BackupLicenses crée une sauvegarde des licences dans le magasin de licences local.

Syntaxe

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

Paramètres

bstrBackupDirectory [in]

Chemin UNC de l’emplacement dans lequel les licences seront sauvegardées.

dwFlags [in]

Indicateurs spécifiant les options de sauvegarde à utiliser. Le seul indicateur actuellement pris en charge est WMDRM_BACKUP_OVERWRITE, qui configure la méthode pour remplacer tous les fichiers de sauvegarde existants dans le répertoire.

ppunkCancelationCookie [out]

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
S_OK
S_OK

Notes

Cette méthode s’exécute de manière asynchrone. Il retourne immédiatement après avoir été appelé, puis génère une série d’événements MEWMDRMLicenseBackupProgress suivis d’un événement MEWMDRMLicenseBackupCompleted une fois le traitement terminé. La valeur de chacun des événements MEWMDRMLicenseBackupProgress 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 obtenir une instance de l’interface IWMDRMLicenseBackupRestoreStatus.

Pour plus d’informations sur l’utilisation des méthodes asynchrones des API étendues du client Windows Media DRM, consultez Utilisation du modèle d’événement Media Foundation.

Toutes les licences ne sont pas autorisées à être sauvegardées. Cette méthode sauvegarde uniquement les licences qui l’autorisent.

Configuration requise

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

Voir aussi

IWMDRMLicenseManagement Interface