Fonction DRMCreateEnablingBitsDecryptor (msdrm.h)

Article
02/29/2024

[Le Kit de développement logiciel (SDK) AD RMS tirant parti des fonctionnalités exposées par

le client dans Msdrm.dll est disponible dans Windows Server 2008, Windows Vista, Windows Server 2008 R2, Windows 7, Windows Server 2012 et Windows 8. Il peut être modifié ou

non disponible dans les versions suivantes. Utilisez plutôt active Directory Rights Management Services SDK 2.1,

qui tire parti des fonctionnalités exposées par le client dans Msipc.dll.]

La fonction DRMCreateEnablingBitsDecryptor crée un objet de déchiffrement qui est utilisé pour déchiffrer les données de contenu.

Syntaxe

DRMEXPORT HRESULT UDAPICALL DRMCreateEnablingBitsDecryptor(
  [in]           DRMHANDLE hBoundLicense,
  [in, optional] PWSTR     wszRight,
  [in]           DRMHANDLE hAuxLib,
  [in, optional] PWSTR     wszAuxPlug,
  [out]          DRMHANDLE *phDecryptor
);

Paramètres

[in] hBoundLicense

Handle d’un objet de licence lié créé à l’aide de DRMCreateBoundLicense.

[in, optional] wszRight

Chaîne null facultative qui contient le droit d’exercer. Un objet de déchiffrement ne peut être lié qu’à un seul droit à la fois.

[in] hAuxLib

Réservé pour un usage futur. Ce paramètre doit avoir la valeur NULL.

[in, optional] wszAuxPlug

Réservé pour un usage futur. Ce paramètre doit avoir la valeur NULL.

[out] phDecryptor

Pointeur vers l’objet de déchiffrement.

Valeur retournée

Si la fonction réussit, la fonction retourne S_OK.

Si la fonction échoue, elle retourne une valeur HRESULT qui indique l’erreur. Les valeurs possibles incluent, sans s’y limiter, celles de la liste suivante. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Remarques

Une application consommatrice effectue les étapes suivantes pour déchiffrer le contenu précédemment chiffré par une application de publication.

Récupérer une licence d’utilisateur final. Appelez DRMEnumerateLicense pour récupérer la licence si elle existe déjà dans le magasin. Si la fonction réussit, passez à l’étape 2. Si la licence n’est pas dans le magasin, appelez DRMAcquireLicense suivi de DRMEnumerateLicense.
Appelez DRMCreateBoundLicense pour créer une licence qui se lie à un ou plusieurs droits dans la licence de l’utilisateur final. La licence liée comprend une clé symétrique qui peut être utilisée pour le déchiffrement.
Appelez DRMCreateEnablingBitsDecryptor pour créer un objet de déchiffrement associé à la clé de contenu et à la droite liées.
Appelez DRMDecrypt pour utiliser la clé de contenu pour déchiffrer le contenu.

Appelez la fonction DRMCloseHandle pour fermer le handle d’objet de déchiffrement lorsque vous avez terminé. Le handle d’objet de déchiffrement et le handle de licence lié doivent rester ouverts jusqu’à ce que le déchiffrement soit terminé.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	msdrm.h
Bibliothèque	Msdrm.lib
DLL	Msdrm.dll

Voir aussi

Fonctions AD RMS

DRMCreateEnablingBitsEncryptor

Déchiffrement de contenu

Partager via