CryptVerifyDetachedMessageHash 函数 (wincrypt.h)

  • 项目

CryptVerifyDetachedMessageHash 函数验证分离的哈希。

语法

BOOL CryptVerifyDetachedMessageHash(
  [in]      PCRYPT_HASH_MESSAGE_PARA pHashPara,
  [in]      BYTE                     *pbDetachedHashBlob,
  [in]      DWORD                    cbDetachedHashBlob,
  [in]      DWORD                    cToBeHashed,
  [in]      const BYTE * []          rgpbToBeHashed,
  [in]      DWORD []                 rgcbToBeHashed,
  [out]     BYTE                     *pbComputedHash,
  [in, out] DWORD                    *pcbComputedHash
);

参数

[in] pHashPara

指向包含哈希参数 的CRYPT_HASH_MESSAGE_PARA 结构的指针。

[in] pbDetachedHashBlob

指向已编码的分离哈希的指针。

[in] cbDetachedHashBlob

分离哈希的大小（以字节为单位）。

[in] cToBeHashed

rgpbToBeHashed 和 rgcbToBeHashed 数组中的元素数。

[in] rgpbToBeHashed

指向要进行哈希处理的内容缓冲区的指针数组。

[in] rgcbToBeHashed

rgcbToBeHashed 数组的元素指向的内容缓冲区的大小数组（以字节为单位）。

[out] pbComputedHash

指向要接收计算哈希的缓冲区的指针。

如果不需要新创建的哈希进行其他处理，或者为内存分配设置哈希大小，则此参数可以为 NULL 。 有关详细信息，请参阅 检索长度未知的数据。

[in, out] pcbComputedHash

指向指定 pbComputedHash 缓冲区大小（以字节为单位）的 DWORD 的指针。 函数返回时，此 DWORD 包含所创建哈希的大小（以字节为单位）。 如果此参数为 NULL，则不会返回哈希。

注意 处理返回的数据时，应用程序必须使用返回的数据的实际大小。 实际大小可以略小于输入时指定的缓冲区的大小。 (输入时，缓冲区大小通常指定得足够大，以确保缓冲区中容纳可能的最大输出数据。) 输出时，此参数指向的变量将更新为反映复制到缓冲区的数据的实际大小。
 

返回值

如果函数成功，则返回值为非零 (TRUE) 。

如果函数失败，则返回值为零， (FALSE) 。

有关扩展的错误信息，请调用 GetLastError。

下面列出了 GetLastError 函数最常返回的错误代码。

返回代码 说明
CRYPT_E_UNEXPECTED_MSG_TYPE
 不是哈希加密消息。
E_INVALIDARG
 消息编码类型无效。 目前仅支持PKCS_7_ASN_ENCODING。 *pHashPara 中的 cbSize 无效。
ERROR_MORE_DATA
 如果 pbComputedHash 参数指定的缓冲区不够大，无法容纳返回的数据，则函数将设置ERROR_MORE_DATA代码，并将所需的缓冲区大小（以字节为单位）存储在 由ERROR_MORE_DATA ComputedHash 指向的变量中。
 
注意 来自调用函数 CryptCreateHash、 CryptHashData 和 CryptGetHashParam 的错误可能会传播到此函数。

如果函数失败， GetLastError 可能会返回 抽象语法表示法 One (ASN.1) 编码/解码错误。 有关这些错误的信息，请参阅 ASN.1 编码/解码返回值。

 

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 wincrypt.h
Library Crypt32.lib
DLL Crypt32.dll

另请参阅

CryptVerifyMessageHash

简化的消息函数