Fonction CertEnumCRLsInStore (wincrypt.h)
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 |
|---|---|
|
Le handle dans le paramètre hCertStore n’est pas le même que dans le contexte de certificat pointé par pPrevCrlContext. |
|
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 |