Fonction CertEnumCRLsInStore (wincrypt.h)

Article
08/27/2023

La fonction CertEnumCRLsInStore récupère le contexte de liste de révocation de certificats (CRL) premier ou suivant dans un magasin de certificats. Utilisée dans une boucle, cette fonction peut récupérer en séquence tous les contextes de liste de révocation de certificats dans un magasin de certificats.

Syntaxe

PCCRL_CONTEXT CertEnumCRLsInStore(
  [in] HCERTSTORE    hCertStore,
  [in] PCCRL_CONTEXT pPrevCrlContext
);

Paramètres

[in] hCertStore

Handle d’un magasin de certificats.

[in] pPrevCrlContext

Pointeur vers la structure CRL_CONTEXT précédente trouvée. Le paramètre pPrevCrlContext doit avoir la valeur NULL pour obtenir la première liste de révocation de certificats dans le magasin. Les listes crl successives sont énumérées en définissant pPrevCrlContext sur le pointeur retourné par un appel précédent à la fonction. Cette fonction libère les CRL_CONTEXT référencés par des valeurs non NULL de ce paramètre. L’énumération ignore toutes les LISTES de contrôle d’accès précédemment supprimées par CertDeleteCRLFromStore.

Valeur retournée

Si la fonction réussit, la valeur de retour est un pointeur vers le CRL_CONTEXT suivant dans le magasin.

La valeur NULL est retournée si la fonction échoue. Pour obtenir des informations d’erreur étendues, appelez GetLastError. Certains codes d’erreur possibles suivent.

Code de retour	Description
E_INVALIDARG	Le handle dans le paramètre hCertStore n’est pas le même que dans le contexte de certificat pointé par pPrevCrlContext.
CRYPT_E_NOT_FOUND	Aucune liste de révocation de certificats n’a été trouvée. Cela se produit si le magasin est vide ou si la fin de la liste du magasin est atteinte.

Remarques

Le pointeur retourné est libéré lorsqu’il est passé en tant que pPrevCrlContext lors d’un appel suivant à la fonction. Sinon, le pointeur doit être explicitement libéré en appelant CertFreeCRLContext. Un pPrevCrlContext qui n’est pas NULL est toujours libéré lorsqu’il est passé à cette fonction via un appel à CertFreeCRLContext, même si la fonction elle-même retourne une erreur.

Un doublon du contexte de liste de révocation de certificats retourné par cette fonction peut être effectué en appelant CertDuplicateCRLContext.

Configuration requise


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