Fonction CertEnumCTLsInStore (wincrypt.h)

Article
08/27/2023

La fonction CertEnumCTLsInStore récupère le premier ou le prochain contexte de liste d’approbation de certificats (CTL) dans un magasin de certificats. Utilisée dans une boucle, cette fonction peut récupérer dans l’ordre tous les contextes CTL dans un magasin de certificats.

Syntaxe

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

Paramètres

[in] hCertStore

Handle d’un magasin de certificats.

[in] pPrevCtlContext

Pointeur vers la structure de CTL_CONTEXT précédente trouvée. Elle doit être NULL pour obtenir la première CTL dans le magasin. Les listes CTL successives sont énumérées en définissant pPrevCtlContext sur le pointeur retourné par un appel précédent. Cette fonction libère les CTL_CONTEXT référencées par des valeurs non NULL de ce paramètre. L’énumération ignore toutes les CTL précédemment supprimées par CertDeleteCTLFromStore.

Valeur retournée

Si la fonction réussit, la valeur de retour est un pointeur vers un CTL_CONTEXT en lecture seule.

Si la fonction échoue et qu’une CTL est introuvable, la valeur de retour est NULL. Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Certains codes d’erreur possibles suivent.

Code de retour	Description
CRYPT_E_NOT_FOUND	Soit il n’existe pas de CTL dans le magasin, soit la fonction a atteint la fin de la liste du magasin.
E_INVALIDARG	Le handle dans le paramètre hCertStore n’est pas le même que dans le contexte CTL pointé par le paramètre pPrevCtlContext .

Remarques

Le pointeur retourné est libéré lorsqu’il est passé en tant que pPrevCtlContext lors d’un appel suivant. Sinon, le pointeur doit être explicitement libéré en appelant CertFreeCTLContext. Un pPrevCtlContext qui n’est pas NULL est toujours libéré par cette fonction (par un appel à CertFreeCTLContext), même pour une erreur.

Vous pouvez effectuer un doublon en appelant CertDuplicateCTLContext.

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