cryptHashPublicKeyInfo 函数 (wincrypt.h)
语法
BOOL CryptHashPublicKeyInfo(
[in] HCRYPTPROV_LEGACY hCryptProv,
[in] ALG_ID Algid,
[in] DWORD dwFlags,
[in] DWORD dwCertEncodingType,
[in] PCERT_PUBLIC_KEY_INFO pInfo,
[out] BYTE *pbComputedHash,
[in, out] DWORD *pcbComputedHash
);
参数
[in] hCryptProv
此参数未使用，应设置为 NULL。
Windows Server 2003 和 Windows XP： 加密服务提供程序的句柄 (CSP) 用于计算哈希。此参数的数据类型为 HCRYPTPROV。
除非有充分的理由在 hCryptProv 中传入特定的加密提供程序，否则传入零。 传入零会导致在执行哈希、签名验证或收件人加密操作之前获取默认 RSA 或数字签名标准 (DSS) 提供程序。
[in] Algid
指定要使用的 CryptoAPI 哈希算法的 ALG_ID 结构。 如果 Algid 为零，则使用默认哈希算法 MD5。
[in] dwFlags
要传递给 CryptCreateHash 的值。
[in] dwCertEncodingType
指定使用的编码类型。 始终可以接受将 证书 和 消息编码类型 与按位 OR 操作组合在一起，如以下示例所示：
X509_ASN_ENCODING |PKCS_7_ASN_ENCODING
当前定义的编码类型包括：
- X509_ASN_ENCODING
- PKCS_7_ASN_ENCODING
[in] pInfo
指向包含要编码和哈希的公钥信息的CERT_PUBLIC_KEY_INFO结构的指针。
[out] pbComputedHash
指向用于接收计算哈希的缓冲区的指针。
若要设置此信息的大小以用于内存分配，此参数可以为 NULL。 有关详细信息，请参阅 检索未知长度的数据。
[in, out] pcbComputedHash
指向 DWORD 的指针，该 DWORD 包含 pbComputedHash 参数指向的缓冲区的大小（以字节为单位）。 函数返回时， DWORD 包含缓冲区中存储的字节数。
返回值
如果函数成功，则函数) 返回非零 (TRUE 。
如果函数失败，它将返回零 (FALSE) 。 有关扩展的错误信息，请调用 GetLastError。
| 返回代码 | 说明 |
|---|---|
|
如果 pbComputedHash 参数指定的缓冲区不够大，无法容纳返回的数据，该函数将设置ERROR_MORE_DATA代码，并将所需的缓冲区大小（以字节为单位）存储在 由Hash 指向的变量中。 |
|
证书编码类型无效。 目前仅支持X509_ASN_ENCODING。 |
如果函数失败， GetLastError 可能会返回 抽象语法表示法 One (ASN.1) 编码/解码错误。 有关这些错误的信息，请参阅 ASN.1 编码/解码返回值。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows XP [桌面应用 | UWP 应用] |
| 最低受支持的服务器 | Windows Server 2003 [桌面应用 | UWP 应用] |
| 目标平台 | Windows |
| 标头 | wincrypt.h |
| Library | Crypt32.lib |
| DLL | Crypt32.dll |