CertEnumCertificatesInStore 函数（wincrypt.h）

项目
07/16/2024

CertEnumCertificatesInStore 函数检索证书存储中的第一个或下一个证书。在循环中使用，此函数可以按顺序检索证书存储中的所有证书。

语法

PCCERT_CONTEXT CertEnumCertificatesInStore(
  [in] HCERTSTORE     hCertStore,
  [in] PCCERT_CONTEXT pPrevCertContext
);

参数

[in] hCertStore

证书存储的句柄。

[in] pPrevCertContext

指向找到的上一个证书上下文 CERT_CONTEXT 的指针。

此参数必须 NULL 才能开始枚举并获取存储中的第一个证书。通过设置 pPrevCertContext 上一次调用函数返回的指针来枚举后续证书。此函数释放参数的非NULL 值引用的 CERT_CONTEXT。

对于逻辑存储（包括集合存储），此函数返回的 pCertContext 的副本不能用于开始枚举的新子序列，因为重复的证书会丢失初始枚举状态。枚举跳过以前由 CertDeleteCertificateFromStore删除的任何证书。

返回值

如果函数成功，该函数将返回指向存储区中下一 CERT_CONTEXT 的指针。如果存储中不存在更多证书，则该函数将返回 NULL 。

有关扩展错误信息，请调用 GetLastError。下面是一些可能的错误代码。

价值	描述
E_INVALIDARG	hCertStore 参数中的句柄与 pPrevCertContext所指向的证书上下文中的句柄不同。
CRYPT_E_NOT_FOUND	未找到证书。如果存储是空的，或者函数到达存储列表的末尾，则发生这种情况。
ERROR_NO_MORE_FILES	适用于外部存储。未找到证书。如果存储是空的，或者函数到达存储列表的末尾，则发生这种情况。

言论

在后续调用中作为 pPrevCertContext 参数传递时，将释放返回的指针。否则，必须通过调用 CertFreeCertificateContext来释放指针。传递给 CertEnumCertificatesInStore 的非NULLpPrevCertContext 始终会释放，即使出现错误也是如此。

可以通过调用 CertDuplicateCertificateContext来生成当前枚举证书的副本。

例子

以下示例列出了证书存储中的证书上下文。有关使用此函数的另一个示例，请参阅示例 C 程序：从证书存储中删除证书。

#include <windows.h>
#include <stdio.h>
#include <Wincrypt.h>
#pragma comment(lib, "crypt32.lib")


//--------------------------------------------------------------------
// Declare and initialize variables.
HANDLE          hStoreHandle = NULL;
PCCERT_CONTEXT  pCertContext = NULL;   
char * pszStoreName = "CA";

//--------------------------------------------------------------------
// Open a system certificate store.
if (hStoreHandle = CertOpenSystemStore(
     NULL,     
     pszStoreName))
    {
         printf("The %s store has been opened. \n", pszStoreName);
    }
    else
    {
         printf("The store was not opened.\n");
         exit(1);
    }

//-------------------------------------------------------------------
// Find the certificates in the system store. 
while(pCertContext= CertEnumCertificatesInStore(
      hStoreHandle,
      pCertContext)) // on the first call to the function,
                     // this parameter is NULL 
                     // on all subsequent calls, 
                     // this parameter is the last pointer 
                     // returned by the function
{
    //----------------------------------------------------------------
    // Do whatever is needed for a current certificate.
    // ...
} // End of while.

//--------------------------------------------------------------------
//   Clean up.
if (!CertCloseStore(
         hStoreHandle,
         0))
{
    printf("Failed CertCloseStore\n");
    exit(1);
}

要求

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