Partager via


Fonction CertEnumCTLsInStore (wincrypt.h)

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

Voir aussi

CTL_CONTEXT

CertDeleteCTLFromStore

CertDuplicateCTLContext

CertFindCTLInStore

CertFreeCTLContext

Fonctions de liste d’approbation de certificats