CertEnumCRLsInStore-Funktion (wincrypt.h)

Artikel
08/27/2023

Die CertEnumCRLsInStore-Funktion ruft den ersten oder nächsten CRL-Kontext ( Certificate Revocation List ) in einem Zertifikatspeicher ab. Diese Funktion wird in einer Schleife verwendet und kann nacheinander alle CRL-Kontexte in einem Zertifikatspeicher abrufen.

Syntax

PCCRL_CONTEXT CertEnumCRLsInStore(
  [in] HCERTSTORE    hCertStore,
  [in] PCCRL_CONTEXT pPrevCrlContext
);

Parameter

[in] hCertStore

Handle eines Zertifikatspeichers.

[in] pPrevCrlContext

Ein Zeiger auf die vorherige gefundene CRL_CONTEXT-Struktur . Der Parameter pPrevCrlContext muss NULL sein, um die erste CRL im Speicher abzurufen. Aufeinanderfolgende CRLs werden aufgelistet, indem pPrevCrlContext auf den Zeiger festgelegt wird, der von einem vorherigen Aufruf der Funktion zurückgegeben wurde. Diese Funktion gibt die CRL_CONTEXT frei, auf die von Werten dieses Parameters ohne NULL verwiesen wird. Die Enumeration überspringt alle crLs, die zuvor von CertDeleteCRLFromStore gelöscht wurden.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Zeiger auf die nächste CRL_CONTEXT im Speicher.

NULL wird zurückgegeben, wenn die Funktion fehlschlägt. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten. Es folgen einige mögliche Fehlercodes.

Rückgabecode	Beschreibung
E_INVALIDARG	Das Handle im hCertStore-Parameter ist nicht dasselbe wie im Zertifikatkontext, auf den pPrevCrlContext verweist.
CRYPT_E_NOT_FOUND	Es wurde keine Zertifikatsperrliste gefunden. Dies geschieht, wenn der Speicher leer ist oder das Ende der Liste des Speichers erreicht ist.

Hinweise

Der zurückgegebene Zeiger wird freigegeben, wenn er bei einem nachfolgenden Aufruf der Funktion als pPrevCrlContext übergeben wird. Andernfalls muss der Zeiger explizit durch Aufrufen von CertFreeCRLContext freigegeben werden. Ein pPrevCrlContext , der nicht NULL ist, wird immer freigegeben, wenn er über einen Aufruf von CertFreeCRLContext an diese Funktion übergeben wird, auch wenn die Funktion selbst einen Fehler zurückgibt.

Ein Duplikat des von dieser Funktion zurückgegebenen CRL-Kontexts kann durch Aufrufen von CertDuplicateCRLContext erstellt werden.

Anforderungen


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