CertCreateCTLContext-Funktion (wincrypt.h)

Artikel
03/03/2024

Die CertCreateCTLContext-Funktion erstellt einen CTL-Kontext ( Certificate Trust List ) aus einer codierten CTL. Der erstellte Kontext wird nicht in einem Zertifikatspeicher beibehalten. Die Funktion erstellt eine Kopie der codierten CTL innerhalb des erstellten Kontexts.

Syntax

PCCTL_CONTEXT CertCreateCTLContext(
  [in] DWORD      dwMsgAndCertEncodingType,
  [in] const BYTE *pbCtlEncoded,
  [in] DWORD      cbCtlEncoded
);

Parameter

[in] dwMsgAndCertEncodingType

Gibt den Typ der verwendeten Codierung an. Sowohl der Zertifikat- als auch der Nachrichtencodierungstyp müssen durch Kombination mit einem bitweisen OR-Vorgang angegeben werden, wie im folgenden Beispiel gezeigt:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING Derzeit definierte Codierungstypen sind:

X509_ASN_ENCODING
PKCS_7_ASN_ENCODING

[in] pbCtlEncoded

Ein Zeiger auf einen Puffer, der die codierte CTL enthält, aus der der Kontext erstellt werden soll.

[in] cbCtlEncoded

Die Größe des Puffers pbCtlEncoded in Bytes.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Zeiger auf eine schreibgeschützte CTL_CONTEXT.

Wenn bei der Funktion ein Fehler auftritt und die CTL_CONTEXT nicht decodiert und erstellt werden kann, lautet der Rückgabewert NULL. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten. Die folgende Tabelle zeigt einen möglichen Fehlercode.

Rückgabecode	Beschreibung
E_INVALIDARG	Ungültiger Zertifikatcodierungstyp. Es werden nur PKCS_7_ASN_ENCODING und X509_ASN_ENCODING unterstützt.

Wenn die Funktion fehlschlägt, gibt GetLastError möglicherweise einen ASN.1-Codierungs-/Decodierungsfehler ( Abstract Syntax Notation One ) zurück. Informationen zu diesen Fehlern finden Sie unter ASN.1 Encoding/Decoding Return Values.

Hinweise

Die CTL_CONTEXT muss durch Aufrufen von CertFreeCTLContext freigegeben werden. CertDuplicateCTLContext kann aufgerufen werden, um ein Duplikat zu erstellen. CertSetCTLContextProperty und CertGetCTLContextProperty können aufgerufen werden, um Eigenschaften für die CTL zu speichern und zu lesen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	wincrypt.h
Bibliothek	Crypt32.lib
DLL	Crypt32.dll