CertStoreProvFindCert 回呼函式

CertStoreProvFindCert回呼函式會列舉或尋找符合指定準則的外部存放區中第一個或下一個憑證。

語法

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

參數

hStoreProv [in]

證書存儲HCERTSTOREPROV控制碼。

pFindInfo [in]

CERT_STORE_PROV_FIND_INFO結構的指標,其中包含傳遞至CertFindCertificateInStore函式的所有參數。

pPrevCertCoNtext [in]

找到之憑證 CERT_CONTEXT 指標。 第一次呼叫 函式時,此參數應該設定為 Null。 在後續的呼叫中,它應該設定為最後一個呼叫上 ppProvCertCoNtext 參數中所傳回的指標。 回呼函式會釋放此參數中傳遞的非Null 指標。

dwFlags [in]

任何所需的旗標值。

ppvStoreProvFindInfo [in, out]

緩衝區指標的指標,可傳回存放區提供者資訊。 或者,回呼可以傳回此參數中內部尋找資訊的指標。 第一次呼叫之後,此參數會設定為先前呼叫函式所傳回的指標。

ppProvCertCoNtext [out]

在成功尋找時,會在此參數中傳回所找到憑證的指標。

傳回值

如果函式成功,則傳回 TRUE ;如果函式失敗,則傳回 FALSE

規格需求

需求
最低支援的用戶端
Windows XP [僅限傳統型應用程式]
最低支援的伺服器
Windows Server 2003 [僅限傳統型應用程式]

另請參閱

CERT_CONTEXT

CERT_STORE_PROV_FIND_INFO

CertFindCertificateInStore