Fonction de rappel CertStoreProvFindCert

  • Article

La fonction de rappel CertStoreProvFindCert énumère ou recherche le premier certificat ou le certificat suivant dans un magasin externe qui correspond aux critères spécifiés.

Syntaxe

BOOL WINAPI CertStoreProvFindCert(
  _In_    HCERTSTOREPROV              hStoreProv,
  _In_    PCCERT_STORE_PROV_FIND_INFO pFindInfo,
  _In_    PCCERT_CONTEXT              pPrevCertContext,
  _In_    DWORD                       dwFlags,
  _Inout_ void                        **ppvStoreProvFindInfo,
  _Out_   PCCERT_CONTEXT              *ppProvCertContext
);

Paramètres

hStoreProv [in]

Gestion HCERTSTOREPROV dans un magasin de certificats.

pFindInfo [in]

Pointeur vers une structure CERT_STORE_PROV_FIND_INFO contenant tous les paramètres passés à la fonction CertFindCertificateInStore .

pPrevCertContext [in]

Pointeur vers un CERT_CONTEXT du certificat trouvé. Lors du premier appel à la fonction, ce paramètre doit être défini sur NULL. Lors des appels suivants, il doit être défini sur le pointeur retourné dans le paramètre ppProvCertContext lors du dernier appel. Un pointeur non NULL passé dans ce paramètre est libéré par la fonction de rappel.

dwFlags [in]

Toutes les valeurs d’indicateur nécessaires.

ppvStoreProvFindInfo [in, out]

Pointeur vers un pointeur vers une mémoire tampon pour retourner les informations du fournisseur de magasin. Si vous le souhaitez, le rappel peut retourner un pointeur vers les informations de recherche internes dans ce paramètre. Après le premier appel, ce paramètre est défini sur le pointeur retourné par l’appel précédent à la fonction.

ppProvCertContext [out]

Lors d’une recherche réussie, un pointeur vers le certificat trouvé est retourné dans ce paramètre.

Valeur retournée

Retourne TRUE si la fonction réussit ou FALSE si elle échoue.

Spécifications

Condition requise Valeur
Client minimal pris en charge
 Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge
 Windows Server 2003 [applications de bureau uniquement]

Voir aussi

CERT_CONTEXT

CERT_STORE_PROV_FIND_INFO

CertFindCertificateInStore