cryptHashToBeSigned 函数 (wincrypt.h)
语法
BOOL CryptHashToBeSigned(
[in] HCRYPTPROV_LEGACY hCryptProv,
[in] DWORD dwCertEncodingType,
[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 中传入特定的加密提供程序，否则传入零。 传入零会导致在执行哈希、签名验证或收件人加密操作之前获取默认 RSA 或数字签名标准 (DSS) 提供程序。
[in] dwCertEncodingType
指定使用的编码类型。 始终可以接受将 证书 和 消息编码类型 与按位 OR 操作组合在一起，如以下示例所示：
X509_ASN_ENCODING |PKCS_7_ASN_ENCODING
当前定义的编码类型包括：
- X509_ASN_ENCODING
- PKCS_7_ASN_ENCODING
[in] pbEncoded
包含要哈希处理的内容的缓冲区的地址。 这是 CERT_SIGNED_CONTENT_INFO的编码形式。
[in] cbEncoded
缓冲区的大小（以字节为单位）。
[out] pbComputedHash
指向用于接收计算哈希的缓冲区的指针。
此参数可以为 NULL ，用于设置此信息的大小，以便进行内存分配。 有关详细信息，请参阅 检索未知长度的数据。
[in, out] pcbComputedHash
指向 DWORD 的指针，该 DWORD 包含 pbComputedHash 参数指向的缓冲区的大小（以字节为单位）。 函数返回时， DWORD 包含缓冲区中存储的字节数。
返回值
如果函数成功，则函数) 返回非零 (TRUE 。
如果函数失败，它将返回零 (FALSE) 。 有关扩展的错误信息，请调用 GetLastError。
| 返回代码 | 说明 |
|---|---|
|
如果 pbComputedHash 参数指定的缓冲区不够大，无法容纳返回的数据，该函数将设置ERROR_MORE_DATA代码，并将所需的缓冲区大小（以字节为单位）存储在 由ERROR_MORE_DATA ComputedHash 指向的变量中。 |
|
证书编码类型无效。 目前仅支持X509_ASN_ENCODING。 |
|
签名算法的 OID) (对象标识符 不会映射到已知或支持的哈希算法。 |
如果函数失败， GetLastError 可能会返回 抽象语法表示法 One (ASN.1) 编码/解码错误。 有关这些错误的信息，请参阅 ASN.1 编码/解码返回值。
要求
| 最低受支持的客户端 | Windows XP [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | wincrypt.h |
| Library | Crypt32.lib |
| DLL | Crypt32.dll |