IWMDRMLicense::CreateSecureDecryptor-Methode

[Das dieser Seite zugeordnete Feature Windows Media Format 11 SDK ist ein Legacyfeature. Es wurde von Source Reader und Sink Writer abgelöst. Source Reader und Sink Writer wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit quellleser und Senkenschreiber anstelle des Windows Media Format 11 SDK verwendet. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die CreateSecureDecryptor-Methode erstellt ein sicheres Entschlüsselungsobjekt. Der sichere Entschlüsseler unterscheidet sich vom normalen Entschlüsseler darin, dass er den Inhalt entschlüsselt und ihn dann gemäß den einstellungen erneut verschlüsselt, die in den Parametern dieser Methode angegeben sind.

Syntax

HRESULT CreateSecureDecryptor(
  [in]      BYTE          *pbCertificate,
  [in]      DWORD         cbCertificate,
  [in]      DWORD         dwCertificateType,
  [in]      DWORD         dwFlags,
  [out]     BYTE          *pbInitializationVector,
  [in, out] DWORD         *pcbInitializationVector,
  [out]     IWMDRMDecrypt **ppDecryptor
);

Parameter

pbCertificate [in]

Zertifikat der aufrufenden Anwendung.

cbCertificate [in]

Größe des Zertifikats in Byte.

dwCertificateType [in]

Der Typ des Zertifikats. Auf WMDRM_CERTIFICATE_TYPE_XML festgelegt.

dwFlags [in]

Der Typ des Sitzungsschutzes, der für die erneute Codierung verwendet werden soll. Muss auf eine der Konstanten in der folgenden Tabelle festgelegt werden:

Konstante	BESCHREIBUNG
WMDRM_PROTECTION_TYPE_RC4	Verwendet die RC4-Verschlüsselung für die Sitzungsverschlüsselung. Dies ist der einzige unterstützte Sitzungsschutz für diese Version.

pbInitializationVector [out]

Empfängt den Initialisierungsvektor. Der Initialisierungsvektor wird mithilfe des OAEP-Auffüllungsschemas mit dem öffentlichen RSA-Schlüssel im Zertifikat verschlüsselt. Legen Sie auf NULL fest, um die erforderliche Puffergröße in pcbInitializationVector zu erhalten.

pcbInitializationVector [in, out]

Bei der Eingabe wird die Größe des Puffers als pbInitializationVector übergeben. Bei der Ausgabe die Größe des verwendeten Teils des Puffers. Wenn Sie NULL für pbInitializationVector übergeben, wird dieser Wert bei der Ausgabe auf die erforderliche Puffergröße festgelegt.

ppDecryptor [out]

Empfängt einen Zeiger auf die IWMDRMDecrypt-Schnittstelle des neu erstellten Objekts.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.

Bemerkungen

Keine.

Anforderungen

Anforderung	Wert
Header	Wmdrmsdk.h

Siehe auch

IWMDRMLicense-Schnittstelle