Fonction de rappel CertStoreProvFindCTL

  • Article

La fonction de rappel CertStoreProvFindCTL énumère ou recherche la première ou la prochaine CTL dans un magasin externe qui correspond aux critères spécifiés.

Syntaxe

BOOL WINAPI CertStoreProvFindCTL(
  _In_    HCERTSTOREPROV              hStoreProv,
  _In_    PCCERT_STORE_PROV_FIND_INFO pFindInfo,
  _In_    PCCTL_CONTEXT               pPrevCtlContext,
  _In_    DWORD                       dwFlags,
  _Inout_ void                        **ppvStoreProvFindInfo,
  _Out_   PCCTL_CONTEXT               *ppProvCtlContext
);

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 au CertFindCTLInStore. CHANGETABLE(CHANGES ...).

pPrevCtlContext [in]

Pointeur vers une structure CTL_CONTEXT de la dernière CTL trouvée. 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 ppProvCTLContext 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 la 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.

ppProvCtlContext [out]

Lors d’une recherche réussie, un pointeur vers la CTL trouvée 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_STORE_PROV_FIND_INFO

CertFindCTLInStore

CTL_CONTEXT