Fonction de rappel CertStoreProvFindCert
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