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 |