CertStoreProvFindCert-Rückruffunktion

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

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 mit allen Parametern, die an die CertFindCertificateInStore-Funktion übergeben werden.

pPrevCertContext [ In]

Ein Zeiger auf einen CERT _ CONTEXT des gefundenen Zertifikats. Beim ersten Aufruf der Funktion sollte dieser Parameter auf NULL festgelegt werden. Bei nachfolgenden Aufrufen sollte sie auf den Zeiger festgelegt werden, der beim letzten Aufruf im ppProvCertContext-Parameter zurückgegeben wurde. Ein in diesem Parameter übergebener Nicht-NULL-Zeiger wird von der Rückruffunktion frei.

dwFlags [ In]

Alle erforderlichen Flagwerte.

ppvStoreProvFindInfo [ in, out]

Ein Zeiger auf einen Zeiger auf einen Puffer, um die Speicheranbieterinformationen zurück zu geben. Optional kann der Rückruf einen Zeiger auf interne Find-Informationen in diesem Parameter zurückgeben. Nach dem ersten Aufruf wird dieser Parameter auf den Zeiger festgelegt, der durch den vorherigen Aufruf der Funktion zurückgegeben wurde.

ppProvCertContext [ out]

Bei einer erfolgreichen 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 Nur [ XP-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]

Weitere Informationen

_CERT-KONTEXT

CERT _ STORE _ PROV _ FIND _ INFO

CertFindCertificateInStore