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