CertEnumCRLsInStore 函数 (wincrypt.h)

项目
08/27/2023

CertEnumCRLsInStore 函数 (CRL) 上下文检索第一个或下一个证书吊销列表。此函数在循环中使用，可以按顺序检索证书存储中的所有 CRL 上下文。

语法

PCCRL_CONTEXT CertEnumCRLsInStore(
  [in] HCERTSTORE    hCertStore,
  [in] PCCRL_CONTEXT pPrevCrlContext
);

参数

[in] hCertStore

证书存储的句柄。

[in] pPrevCrlContext

指向找到的上一个CRL_CONTEXT 结构的指针。 pPrevCrlContext 参数必须为 NULL 才能获取存储中的第一个 CRL。通过将 pPrevCrlContext 设置为先前调用函数返回的指针来枚举连续 CRL。此函数释放由此参数的非 NULL 值引用的CRL_CONTEXT。枚举将跳过以前由 CertDeleteCRLFromStore 删除的任何 CRL。

返回值

如果函数成功，则返回值是指向存储中的下一个CRL_CONTEXT 的指针。

如果函数失败，则返回 NULL。有关扩展的错误信息，请调用 GetLastError。一些可能的错误代码随之而来。

返回代码	说明
E_INVALIDARG	hCertStore 参数中的句柄与 pPrevCrlContext 指向的证书上下文中的句柄不同。
CRYPT_E_NOT_FOUND	找不到 CRL。如果存储为空或到达应用商店列表的末尾，则会发生此情况。

注解

在后续调用函数时，当返回的指针作为 pPrevCrlContext 传递时，将释放该指针。否则，必须通过调用 CertFreeCRLContext 显式释放指针。通过调用 CertFreeCRLContext 传递给此函数时，始终释放非 NULL 的 pPrevCrlContext，即使函数本身返回错误也是如此。

可以通过调用 CertDuplicateCRLContext 来复制此函数返回的 CRL 上下文。

要求


最低受支持的客户端	Windows XP [桌面应用 \| UWP 应用]
最低受支持的服务器	Windows Server 2003 [桌面应用 \| UWP 应用]
目标平台	Windows
标头	wincrypt.h
Library	Crypt32.lib
DLL	Crypt32.dll