cryptHashCertificate 函数 (wincrypt.h)
重要 此 API 已弃用。 新的和现有的软件应开始使用 加密下一代 API。 Microsoft 可能会在将来的版本中删除此 API。
语法
BOOL CryptHashCertificate(
[in] HCRYPTPROV_LEGACY hCryptProv,
[in] ALG_ID Algid,
[in] DWORD dwFlags,
[in] const BYTE *pbEncoded,
[in] DWORD cbEncoded,
[out] BYTE *pbComputedHash,
[in, out] DWORD *pcbComputedHash
);
参数
[in] hCryptProv
此参数未使用，应设置为 NULL。
Windows Server 2003 和 Windows XP： 加密服务提供程序的句柄 (CSP) 用于计算哈希。
此参数的数据类型为 HCRYPTPROV。
除非有充分的理由在 hCryptProv 中传入特定 CSP，否则传入零。 传入零会导致在执行哈希、签名验证或收件人加密操作之前获取默认 RSA 或 数字签名标准 (DSS) 提供程序。
[in] Algid
指定要使用的哈希算法的ALG_ID结构。 如果 Algid 为零，则使用默认哈希算法 SHA1。
[in] dwFlags
要传递给哈希 API 的值。 有关详细信息，请参阅 CryptCreateHash。
[in] pbEncoded
要进行哈希处理的编码内容的地址。
[in] cbEncoded
编码内容的大小（以字节为单位）。
[out] pbComputedHash
指向用于接收计算哈希的缓冲区的指针。
若要设置此信息的大小以用于内存分配，此参数可以为 NULL。 有关详细信息，请参阅 检索未知长度的数据。
[in, out] pcbComputedHash
指向 DWORD 的指针，该 DWORD 包含 pbComputedHash 参数指向的缓冲区的大小（以字节为单位）。 函数返回时， DWORD 包含缓冲区中存储的字节数。
注意 处理缓冲区中返回的数据时，应用程序需要使用返回的数据的实际大小。 实际大小可以略小于输入时指定的缓冲区的大小。 在输入时，缓冲区大小通常指定得足够大，以确保缓冲区中容纳可能的最大输出数据。 输出时，此参数指向的变量将更新，以反映复制到缓冲区的数据的实际大小。
返回值
如果函数成功，则函数) 返回非零 (TRUE 。
如果函数失败，它将返回零 (FALSE) 。 有关扩展的错误信息，请调用 GetLastError。
要求
| 最低受支持的客户端 | Windows XP [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | wincrypt.h |
| Library | Crypt32.lib |
| DLL | Crypt32.dll |