Funzione callback CertStoreProvFindCert

  • Articolo

La funzione di callback CertStoreProvFindCert enumera o trova il primo o successivo certificato in un archivio esterno che corrisponde ai criteri specificati.

Sintassi

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
);

Parametri

hStoreProv [in]

Handle HCERTSTOREPROV in un archivio certificati.

pFindInfo [in]

Puntatore a una struttura CERT_STORE_PROV_FIND_INFO contenente tutti i parametri passati alla funzione CertFindCertificateInStore .

pPrevCertContext [in]

Puntatore a un CERT_CONTEXT del certificato trovato. Nella prima chiamata alla funzione, questo parametro deve essere impostato su NULL. Nelle chiamate successive, deve essere impostato sul puntatore restituito nel parametro ppProvCertContext nell'ultima chiamata. Un puntatore non NULL passato in questo parametro viene liberato dalla funzione di callback.

dwFlags [in]

Tutti i valori del flag necessari.

ppvStoreProvFindInfo [in, out]

Puntatore a un puntatore a un buffer per restituire le informazioni sul provider di archiviazione. Facoltativamente, il callback può restituire un puntatore alla ricerca interna delle informazioni in questo parametro. Dopo la prima chiamata, questo parametro viene impostato sul puntatore restituito dalla chiamata precedente alla funzione.

ppProvCertContext [out]

In una ricerca riuscita viene restituito un puntatore al certificato trovato in questo parametro.

Valore restituito

Restituisce TRUE se la funzione ha esito positivo o FALSE se ha esito negativo.

Requisiti

Requisito Valore
Client minimo supportato
 Windows XP [solo app desktop]
Server minimo supportato
 Windows Server 2003 [solo app desktop]

Vedi anche

CERT_CONTEXT

CERT_STORE_PROV_FIND_INFO

CertFindCertificateInStore