cryptHashMessage 函数 (wincrypt.h)
CryptHashMessage 函数创建消息的哈希。
语法
BOOL CryptHashMessage(
[in] PCRYPT_HASH_MESSAGE_PARA pHashPara,
[in] BOOL fDetachedHash,
[in] DWORD cToBeHashed,
[in] const BYTE * [] rgpbToBeHashed,
[in] DWORD [] rgcbToBeHashed,
[out] BYTE *pbHashedBlob,
[in, out] DWORD *pcbHashedBlob,
[out, optional] BYTE *pbComputedHash,
[in, out, optional] DWORD *pcbComputedHash
);
参数
[in] pHashPara
指向包含哈希参数 的 CRYPT_HASH_MESSAGE_PARA 结构的指针。
[in] fDetachedHash
如果此参数设置为 TRUE,则只有 pbComputedHash 以 pbHashedBlob 编码。 否则,将同时对 rgpbToBeHashed 和 pbComputedHash 进行编码。
[in] cToBeHashed
rgpbToBeHashed 和 rgcbToBeHashed 中的数组元素数。 除非 fDetachedHash 设置为 TRUE,否则此参数只能为 1。
[in] rgpbToBeHashed
指向包含要哈希处理的内容的缓冲区的指针数组。
[in] rgcbToBeHashed
由 rgpbToBeHashed 指向的缓冲区的大小数组(以字节为单位)。
[out] pbHashedBlob
指向缓冲区的指针,用于接收编码为传输的哈希消息。
如果不需要经过哈希处理的消息进行其他处理或设置经过哈希处理的消息的大小以便进行内存分配,则此参数可以为 NULL 。 如果此参数为 NULL,则不会返回经过哈希处理的消息。 有关详细信息,请参阅 检索未知长度的数据。
[in, out] pcbHashedBlob
指向 DWORD 的指针,指定 pbHashedBlob 参数指向的缓冲区的大小(以字节为单位)。 当函数返回时,此变量包含复制到 pbHashedBlob 的解密消息的大小(以字节为单位)。 此参数必须是 DWORD 的地址,而不是 NULL ,否则不会返回缓冲区的长度。
[out, optional] pbComputedHash
指向用于接收新创建的哈希值的缓冲区的指针。 如果不需要新创建的哈希进行其他处理,或者为内存分配目的设置哈希大小,则此参数可以为 NULL 。 有关详细信息,请参阅 检索未知长度的数据。
[in, out, optional] pcbComputedHash
指向 DWORD 的指针,该 DWORD 指定 pbComputedHash 参数指向的缓冲区的大小(以字节为单位)。 当函数返回时,此 DWORD 包含复制到 pbComputedHash 的新创建的哈希的大小(以字节为单位)。
返回值
如果函数成功,则函数) 返回非零 (TRUE 。
如果函数失败,它将返回零 (FALSE) 。 有关扩展的错误信息,请调用 GetLastError。
返回代码 | 说明 |
---|---|
|
消息编码类型无效。 目前仅支持PKCS_7_ASN_ENCODING。 *pHashPara 中的 cbSize 无效。 |
|
如果 pbHashedBlob 参数指定的缓冲区不够大,无法容纳返回的数据,该函数将设置ERROR_MORE_DATA代码,并将所需的缓冲区大小(以字节为单位)存储在 pbHashedBlob 指向的变量中。 |
如果函数失败, GetLastError 可能会返回 抽象语法表示法 One (ASN.1) 编码/解码错误。 有关这些错误的信息,请参阅 ASN.1 编码/解码返回值。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | wincrypt.h |
Library | Crypt32.lib |
DLL | Crypt32.dll |