CertCreateCertificateChainEngine-Funktion (wincrypt.h)

Die CertCreateCertificateChainEngine-Funktion erstellt eine neue, nicht standardmäßige Ketten-Engine für eine Anwendung. Eine Ketten-Engine schränkt die Zertifikate im Stammspeicher ein, die für die Überprüfung verwendet werden können, schränkt die Suche nach Zertifikaten und Zertifikatvertrauenslisten (Certificate Trust Lists , CTLs) ein, legt ein Timeoutlimit für Suchen fest, die URLs umfassen, und schränkt die Anzahl der Zertifikate ein, die zwischen der Überprüfung auf einen Zertifikatzyklus überprüft werden.

Syntax

BOOL CertCreateCertificateChainEngine(
  [in]  PCERT_CHAIN_ENGINE_CONFIG pConfig,
  [out] HCERTCHAINENGINE          *phChainEngine
);

Parameter

[in] pConfig

Ein Zeiger auf eine CERT_CHAIN_ENGINE_CONFIG Datenstruktur, die die Parameter für die Ketten-Engine angibt.

[out] phChainEngine

Ein Zeiger auf den Handle der erstellten Ketten-Engine. Wenn Sie die Ketten-Engine verwendet haben, lassen Sie die Ketten-Engine los, indem Sie die CertFreeCertificateChainEngine-Funktion aufrufen.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion nonzero (TRUE) zurück.

Wenn die Funktion fehlschlägt, gibt sie null (FALSE) zurück. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

Der parameter phChainEngine gibt das Ketten-Engine-Handle zurück.

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

Weitere Informationen

CERT_CHAIN_ENGINE_CONFIG

CertFreeCertificateChainEngine

Zertifikatkettenüberprüfungsfunktionen

GetLastError