CertEnumCTLsInStore-Funktion (wincrypt.h)

Artikel
03/03/2024

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

Syntax

PCCTL_CONTEXT CertEnumCTLsInStore(
  [in] HCERTSTORE    hCertStore,
  [in] PCCTL_CONTEXT pPrevCtlContext
);

Parameter

[in] hCertStore

Handle eines Zertifikatspeichers.

[in] pPrevCtlContext

Ein Zeiger auf die vorherige CTL_CONTEXT-Struktur gefunden. Es muss NULL sein, um die erste CTL im Store zu erhalten. Nachfolgende CTLs werden aufgelistet, indem pPrevCtlContext auf den Zeiger festgelegt wird, der von einem vorherigen Aufruf zurückgegeben wird. Diese Funktion gibt die CTL_CONTEXT frei, auf die von Nicht-NULL-Werten dieses Parameters verwiesen wird. Die Enumeration überspringt alle CTLs, die zuvor von CertDeleteCTLFromStore gelöscht wurden.

Rückgabewert

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

Wenn die Funktion fehlschlägt und keine CTL gefunden wird, ist der Rückgabewert NULL. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

Es folgen einige mögliche Fehlercodes.

Rückgabecode	Beschreibung
CRYPT_E_NOT_FOUND	Entweder sind keine CTLs im Speicher vorhanden, oder die Funktion hat das Ende der Liste des Speichers erreicht.
E_INVALIDARG	Das Handle im hCertStore-Parameter ist nicht dasselbe wie im CTL-Kontext, auf den der pPrevCtlContext-Parameter verweist.

Hinweise

Der zurückgegebene Zeiger wird freigegeben, wenn er bei einem nachfolgenden Aufruf als pPrevCtlContext übergeben wird. Andernfalls muss der Zeiger explizit durch Aufrufen von CertFreeCTLContext freigegeben werden. Ein pPrevCtlContext , der nicht NULL ist, wird immer von dieser Funktion (durch einen Aufruf von CertFreeCTLContext) freigegeben, auch wenn es sich um einen Fehler handelt.

Ein Duplikat kann erstellt werden, indem CertDuplicateCTLContext aufgerufen wird.

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