Funzione callback CertStoreProvFindCert
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