CertCreateCRLContext-Funktion (wincrypt.h)

Artikel
03/03/2024

Die CertCreateCRLContext-Funktion erstellt einen Zertifikatsperrlistenkontext (Certificate Revocation List, CRL) aus einer codierten Zertifikatsperrliste. Der erstellte Kontext wird nicht in einem Zertifikatspeicher gespeichert. Es erstellt eine Kopie der codierten Zertifikatsperrliste innerhalb des erstellten Kontexts.

Syntax

PCCRL_CONTEXT CertCreateCRLContext(
  [in] DWORD      dwCertEncodingType,
  [in] const BYTE *pbCrlEncoded,
  [in] DWORD      cbCrlEncoded
);

Parameter

[in] dwCertEncodingType

Gibt den verwendeten Codierungstyp an. Es ist immer akzeptabel, sowohl den Zertifikat- als auch den Nachrichtencodierungstyp anzugeben, indem sie mit einem bitweisen OR-Vorgang kombiniert 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] pbCrlEncoded

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

[in] cbCrlEncoded

Die Größe des Puffers pbCrlEncoded in Bytes.

Rückgabewert

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

Wenn die Funktion fehlschlägt und die CRL_CONTEXT nicht decodieren und erstellen kann, ist 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. Derzeit wird nur der Codierungstyp 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-Rückgabewerte für Codierung/Decodierung.

Hinweise

Die CRL_CONTEXT muss durch Aufrufen von CertFreeCRLContext freigegeben werden. CertDuplicateCRLContext kann aufgerufen werden, um ein Duplikat zu erstellen. CertSetCRLContextProperty und CertGetCRLContextProperty können aufgerufen werden, um Eigenschaften für die CRL 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