CertEnumCRLsInStore-Funktion (wincrypt.h)
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 |
|---|---|
|
Das Handle im hCertStore-Parameter ist nicht dasselbe wie im Zertifikatkontext, auf den pPrevCrlContext verweist. |
|
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 |