Fonction DRMCreateEnablingBitsEncryptor (msdrm.h)

Article
08/24/2023

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

le client dans Msdrm.dll peut être utilisé 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 DRMCreateEnablingBitsEncryptor crée un objet de chiffrement AD RMS qui est utilisé pour chiffrer les données de contenu.

Syntaxe

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

Paramètres

[in] hBoundLicense

Handle pour une licence liée, produite par DRMCreateBoundLicense.

[in, optional] wszRight

Chaîne terminée par null facultative contenant un droit. Si vous spécifiez NULL, l’objet de chiffrement AD RMS est lié au premier droit valide de la licence.

[in] hAuxLib

Réservé pour un usage futur. Ce paramètre doit être NULL.

[in, optional] wszAuxPlug

Réservé pour un usage futur. Ce paramètre doit être NULL.

[out] phEncryptor

Pointeur vers l’objet de 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. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Notes

Effectuez les étapes suivantes pour chiffrer le contenu. Pour plus d’informations, consultez Chiffrement du contenu.

Acquérir une licence d’utilisateur final. Si la licence d’émission que vous utilisez à cet effet a été signée en ligne, appelez DRMAcquireLicense suivi de DRMEnumerateLicense. Si la licence d’émission a été signée hors connexion, appelez DRMGetOwnerLicense à la place.
Appelez DRMCreateBoundLicense pour créer une licence qui lie au droit EDIT ou OWNER dans la licence de l’utilisateur final. La licence liée inclut une clé symétrique qui peut être utilisée pour le chiffrement.
Appelez DRMCreateEnablingBitsEncryptor pour créer un objet de chiffrement associé à la droite et à la clé de contenu liées.
Appelez DRMEncrypt pour utiliser la clé de contenu pour chiffrer le contenu.

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