Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[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 DRMConstructCertificateChain-Funktion erstellt eine Zertifikatkette aus einer beliebigen Anzahl von Zertifikaten.
Syntax
DRMEXPORT HRESULT UDAPICALL DRMConstructCertificateChain(
[in] UINT cCertificates,
[in] PWSTR *rgwszCertificates,
[in, out] UINT *pcChain,
[out] PWSTR wszChain
);
Parameter
[in] cCertificates
Die Anzahl der Zertifikate im Array rgwszCertificates .
[in] rgwszCertificates
Ein Array von Unicode-Zeichenfolgenzeigern mit NULL-Beendigung, die die Zertifikate zum Erstellen der Kette enthalten. Die Anzahl der Elemente in diesem Array wird durch den Parameter cCertificates angegeben.
[in, out] pcChain
Ein Zeiger auf einen UINT , der bei der Eingabe die Größe der wszChain-Zeichenfolge in Unicode-Zeichen enthält. Diese Zeichenanzahl muss das beendende NULL-Zeichen enthalten.
Bei der Ausgabe empfängt dieser UINT die Anzahl der Unicode-Zeichen, die in den Puffer kopiert wurden, einschließlich des beendenden NULL-Zeichens.
[out] wszChain
Ein Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die die konstruierte Kette empfängt.
Um die erforderliche Größe für diesen Puffer zu bestimmen, rufen Sie diese Funktion mit NULL für den wszChain-Parameter auf. Die erforderliche Anzahl von Unicode-Zeichen, einschließlich des beendenden NULL-Zeichens, wird im pcChain-Parameter zurückgegeben.
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
Die Speicherzuordnung und die Deallocation für die Kette werden vom Aufrufer verarbeitet. Um die erforderliche Größe für den wszChain-Puffer zu bestimmen, rufen Sie diese Funktion mit NULL für den wszChain-Parameter auf. Die erforderliche Anzahl von Unicode-Zeichen, einschließlich des beendenden NULL-Zeichens, wird im pcChain-Parameter zurückgegeben.
Mit dieser Funktion können Zertifikatketten, die von den AD RMS SOAP-Methoden zurückgegeben werden, in Zertifikatketten transformiert werden, die von AD RMS-Funktionen verwendet werden können. Ein Beispiel finden Sie unter Decryption_GetBoundLicense.cpp.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | msdrm.h |
| Bibliothek | Msdrm.lib |
| DLL | Msdrm.dll |