cryptHashToBeSigned 函数 (wincrypt.h)

  • 项目
重要 此 API 已弃用。 新的和现有的软件应开始使用 加密下一代 API。 Microsoft 可能会在将来的版本中删除此 API。
 
CryptHashToBeSigned 函数从已签名和编码的证书中计算编码内容的哈希。 仅对“待签名”编码内容及其签名执行哈希。

语法

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。

注意 来自调用函数 CryptCreateHash、 CryptGetHashParam 和 CryptHashData 的错误可能会传播到此函数。 此函数具有以下错误代码。
 
返回代码 说明
ERROR_MORE_DATA
 如果 pbComputedHash 参数指定的缓冲区不够大，无法容纳返回的数据，该函数将设置ERROR_MORE_DATA代码，并将所需的缓冲区大小（以字节为单位）存储在 由ERROR_MORE_DATA ComputedHash 指向的变量中。
ERROR_FILE_NOT_FOUND
 证书编码类型无效。 目前仅支持X509_ASN_ENCODING。
NTE_BAD_ALGID
 签名算法的 OID) (对象标识符 不会映射到已知或支持的哈希算法。
 

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

要求

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

另请参阅

CryptHashCertificate

CryptHashPublicKeyInfo

数据管理函数