Rückruffunktion CertStoreProvFindCert

Die Rückruffunktion CertStoreProvFindCert listet oder sucht das erste oder nächste Zertifikat in einem externen Speicher , der den angegebenen Kriterien entspricht.

Syntax

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

Parameter

hStoreProv [in]

HCERTSTOREPROV-Handle für einen Zertifikatspeicher.

pFindInfo [in]

Ein Zeiger auf eine CERT_STORE_PROV_FIND_INFO-Struktur , die alle Parameter enthält, die an die CertFindCertificateInStore-Funktion übergeben werden.

pPrevCertContext [in]

Ein Zeiger auf eine CERT_CONTEXT des gefundenen Zertifikats. Beim ersten Aufruf der Funktion sollte dieser Parameter auf NULL festgelegt werden. Bei nachfolgenden Aufrufen sollte er auf den Zeiger festgelegt werden, der im ppProvCertContext-Parameter beim letzten Aufruf zurückgegeben wurde. Ein nicht NULL-Zeiger , der in diesem Parameter übergeben wird, wird von der Rückruffunktion freigegeben.

dwFlags [in]

Alle erforderlichen Flagwerte.

ppvStoreProvFindInfo [in, out]

Ein Zeiger auf einen Zeiger auf einen Puffer, um die Informationen des Speicheranbieters zurückzugeben. Optional kann der Rückruf einen Zeiger auf interne Suchinformationen in diesem Parameter zurückgeben. Nach dem ersten Aufruf wird dieser Parameter auf den Zeiger festgelegt, der vom vorherigen Aufruf der Funktion zurückgegeben wurde.

ppProvCertContext [out]

Bei erfolgreicher Suche wird in diesem Parameter ein Zeiger auf das gefundene Zertifikat zurückgegeben.

Rückgabewert

Gibt TRUE zurück, wenn die Funktion erfolgreich ist, oder FALSE , wenn sie fehlschlägt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]

Siehe auch

CERT_CONTEXT

CERT_STORE_PROV_FIND_INFO

CertFindCertificateInStore