DRMCreateEnablingBitsDecryptor-Funktion (msdrm.h)

[Das AD RMS SDK, das die von verfügbar gemachten Funktionen nutzt

Der Client in Msdrm.dll steht für die Verwendung in Windows Server 2008, Windows Vista, Windows Server 2008 R2, Windows 7, Windows Server 2012 und Windows 8 zur Verfügung. Sie kann geändert werden oder

in nachfolgenden Versionen nicht verfügbar. Verwenden Sie stattdessen das Active Directory Rights Management Services SDK 2.1.

die vom Client in Msipc.dll verfügbar gemachte Funktionalität nutzt.]

Die DRMCreateEnablingBitsDecryptor-Funktion erstellt ein Entschlüsselungsobjekt, das zum Entschlüsseln von Inhaltsdaten verwendet wird.

Syntax

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

Parameter

[in] hBoundLicense

Ein Handle für ein mit DRMCreateBoundLicense erstelltes gebundenes Lizenzobjekt.

[in, optional] wszRight

Eine optionale NULL-beendete Zeichenfolge, die das Recht zum Üben enthält. Ein Entschlüsselungsobjekt kann jeweils nur an ein Objekt gebunden werden.

[in] hAuxLib

Für die zukünftige Verwendung reserviert. Dieser Parameter muss NULL sein.

[in, optional] wszAuxPlug

Für die zukünftige Verwendung reserviert. Dieser Parameter muss NULL sein.

[out] phDecryptor

Ein Zeiger auf das Entschlüsselungsobjekt.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion S_OK zurück.

Wenn die Funktion fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Mögliche Werte sind unter anderem die Werte in der folgenden Liste. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Hinweise

Eine verbrauchende Anwendung führt die folgenden Schritte aus, um Inhalte zu entschlüsseln, die zuvor von einer Veröffentlichungsanwendung verschlüsselt wurden.

  1. Rufen Sie eine Endbenutzerlizenz ab. Rufen Sie DRMEnumerateLicense auf, um die Lizenz abzurufen, wenn sie bereits im Store vorhanden ist. Wenn die Funktion erfolgreich ist, fahren Sie mit Schritt 2 fort. Wenn sich die Lizenz nicht im Speicher befindet, rufen Sie DRMAcquireLicense gefolgt von DRMEnumerateLicense auf.
  2. Rufen Sie DRMCreateBoundLicense auf, um eine Lizenz zu erstellen, die an eine oder mehrere Rechte in der Endbenutzerlizenz gebunden ist. Die gebundene Lizenz enthält einen symmetrischen Schlüssel, der für die Entschlüsselung verwendet werden kann.
  3. Rufen Sie DRMCreateEnablingBitsDecryptor auf, um ein Entschlüsselungsobjekt zu erstellen, das dem gebundenen Rechts- und Inhaltsschlüssel zugeordnet ist.
  4. Rufen Sie DRMDecrypt auf, um den Inhaltsschlüssel zum Entschlüsseln des Inhalts zu verwenden.

Rufen Sie die DRMCloseHandle-Funktion auf, um das Entschlüsselungsobjekthandle zu schließen, wenn Sie damit fertig sind. Sowohl das Entschlüsselungshandle als auch das gebundene Lizenzhandle müssen geöffnet bleiben, bis die Entschlüsselung abgeschlossen ist.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile msdrm.h
Bibliothek Msdrm.lib
DLL Msdrm.dll

Weitere Informationen

AD RMS-Funktionen

DRMCreateEnablingBitsEncryptor

Entschlüsseln von Inhalten