cryptHashMessage 函数 (wincrypt.h)

项目
03/13/2024

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。

注意来自调用函数 CryptCreateHash、 CryptHashData 和 CryptGetHashParam 的错误可能会传播到此函数。

GetLastError 函数最常返回以下错误代码。

返回代码	说明
E_INVALIDARG	消息编码类型无效。目前仅支持PKCS_7_ASN_ENCODING。 *pHashPara 中的 cbSize 无效。
ERROR_MORE_DATA	如果 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

另请参阅

CryptVerifyDetachedMessageHash

CryptVerifyMessageHash

简化的消息函数

cryptHashMessage 函数 (wincrypt.h)

语法

参数

返回值

要求

另请参阅

反馈

反馈

其他资源