DRMCreateEnablingBitsEncryptor-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 DRMCreateEnablingBitsEncryptor-Funktion erstellt ein AD RMS-Verschlüsselungsobjekt, das zum Verschlüsseln von Inhaltsdaten verwendet wird.

Syntax

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

Parameter

[in] hBoundLicense

Ein Handle für eine gebundene Lizenz, die von DRMCreateBoundLicense erstellt wird.

[in, optional] wszRight

Optionale NULL-Zeichenfolge, die eine Rechte enthält. Wenn Sie NULL angeben, wird das AD RMS-Verschlüsselungsobjekt an das erste gültige Recht in der Lizenz gebunden.

[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] phEncryptor

Ein Zeiger auf das verschlüsselnde Objekt.

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. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Hinweise

Führen Sie die folgenden Schritte aus, um Inhalte zu verschlüsseln. Weitere Informationen finden Sie unter Verschlüsseln von Inhalten.

• Erwerben Sie eine Endbenutzerlizenz. Wenn die Ausstellungslizenz, die Sie zu diesem Zweck verwenden, online signiert wurde, rufen Sie DRMAcquireLicense und dann DRMEnumerateLicense auf. Wenn die Ausstellungslizenz offline signiert wurde, rufen Sie stattdessen DRMGetOwnerLicense auf.
• Rufen Sie DRMCreateBoundLicense auf, um eine Lizenz zu erstellen, die an das EDIT- oder OWNER-Recht in der Endbenutzerlizenz gebunden ist. Die gebundene Lizenz enthält einen symmetrischen Schlüssel, der für die Verschlüsselung verwendet werden kann.
• Rufen Sie DRMCreateEnablingBitsEncryptor auf, um ein verschlüsselndes Objekt zu erstellen, das dem gebundenen Rechts- und Inhaltsschlüssel zugeordnet ist.
• Rufen Sie DRMEncrypt auf, um den Inhalt mit dem Inhaltsschlüssel zu verschlüsseln.

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

Requirements (Anforderungen)

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

Weitere Informationen

AD RMS-Funktionen

Erstellen und Verwenden von Ausstellungslizenzen

DRMCreateEnablingBitsDecryptor

Verschlüsseln von Inhalten