Fonction CertCreateCertificateChainEngine (wincrypt.h)

  • Article

La fonction CertCreateCertificateChainEngine crée un nouveau moteur de chaîne non par défaut pour une application. Un moteur de chaîne restreint les certificats du magasin racine qui peuvent être utilisés pour la vérification, restreint la recherche de certificats et de listes d’approbation de certificats (CTL), définit une limite de délai d’attente pour les recherches qui impliquent des URL et limite le nombre de certificats vérifiés entre la vérification d’un cycle de certificat.

Syntaxe

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

Paramètres

[in] pConfig

Pointeur vers une structure de données CERT_CHAIN_ENGINE_CONFIG qui spécifie les paramètres du moteur de chaîne.

[out] phChainEngine

Pointeur vers la poignée du moteur de chaîne créé. Une fois que vous avez terminé d’utiliser le moteur de chaîne, relâchez le moteur de chaîne en appelant la fonction CertFreeCertificateChainEngine .

Valeur retournée

Si la fonction réussit, la fonction retourne une valeur différente de zéro (TRUE).

Si la fonction échoue, elle retourne zéro (FALSE). Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Le paramètre phChainEngine retourne le handle du moteur de chaîne.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête wincrypt.h
Bibliothèque Crypt32.lib
DLL Crypt32.dll

Voir aussi

CERT_CHAIN_ENGINE_CONFIG

CertFreeCertificateChainEngine

Fonctions de vérification de la chaîne de certificats

Obtenir la dernière erreur