CertEnumCertificateContextProperties 函数 (wincrypt.h)

CertEnumCertificateContextProperties 函数检索与证书上下文关联的第一个或下一个扩展属性。 在循环中使用,此函数可以按顺序检索与 证书上下文关联的所有扩展属性。

语法

DWORD CertEnumCertificateContextProperties(
  [in] PCCERT_CONTEXT pCertContext,
  [in] DWORD          dwPropId
);

参数

[in] pCertContext

指向包含要枚举的属性的证书 CERT_CONTEXT 结构的指针。

[in] dwPropId

枚举的最后一个属性的属性编号。 若要获取第一个属性, dwPropId 为零。 若要检索后续属性, 请将 dwPropId 设置为最后一次调用函数返回的属性号。 若要枚举所有属性,函数调用将继续,直到函数返回零。

应用程序可以使用此函数返回的 dwPropId 调用 CertGetCertificateContextProperty,以检索该属性的数据。

返回值

返回值是标识证书上下文属性的DWORD 值。 函数的一次调用返回的 DWORD 值可以作为对函数的后续调用中的 dwPropId 提供。 如果没有更多要枚举的属性,或者函数失败,则返回零。

注解

CERT_KEY_PROV_HANDLE_PROP_ID和CERT_KEY_SPEC_PROP_ID属性存储为CERT_KEY_CONTEXT_PROP_ID属性的成员。 它们不单独枚举。

示例

请参阅 示例 C 程序:列出存储中的证书

要求

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

另请参阅

CERT_CONTEXT

CertGetCertificateContextProperty

扩展属性函数