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
);
parameters
-
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 [仅限桌面应用] |
另请参阅