CryptSignMessageWithKey 函数 (wincrypt.h)

  • 项目

CryptSignMessageWithKey 函数使用参数中指定的 CSP 私钥对消息进行签名。 将创建占位符 SignerId 并将其存储在消息中。

语法

BOOL CryptSignMessageWithKey(
  [in]      PCRYPT_KEY_SIGN_MESSAGE_PARA pSignPara,
  [in]      const BYTE                   *pbToBeSigned,
  [in]      DWORD                        cbToBeSigned,
  [out]     BYTE                         *pbSignedBlob,
  [in, out] DWORD                        *pcbSignedBlob
);

参数

[in] pSignPara

指向包含签名参数 的CRYPT_KEY_SIGN_MESSAGE_PARA 结构的指针。

[in] pbToBeSigned

指向包含要签名的消息的缓冲区数组的指针。

[in] cbToBeSigned

pbToBeSigned 缓冲区数组中的数组元素数。

[out] pbSignedBlob

指向缓冲区的指针，用于接收编码的带符号消息。

此参数可以为 NULL ，用于设置此信息的大小，以便进行内存分配。 有关详细信息，请参阅 检索长度未知的数据。

[in, out] pcbSignedBlob

指向 DWORD 值的指针，该值指示 pbSignedBlob 缓冲区的大小（以字节为单位）。 函数返回时，此变量包含带符号和编码消息的大小（以字节为单位）。

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

返回值

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

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

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

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

返回代码 说明
ERROR_MORE_DATA
 如果 pbSignedBlob 参数指定的缓冲区不够大，无法容纳返回的数据，则函数将设置ERROR_MORE_DATA代码，并将所需的缓冲区大小（以字节为单位）存储在 由ERROR_MORE_DATA Blob 指向的变量中。
E_INVALIDARG
 消息编码类型无效。 目前仅支持PKCS_7_ASN_ENCODING。 *pSignPara 中的 cbSize 无效。
CRYPT_E_NO_KEY_PROPERTY
 *pSignPara 中的 pSigningCert 没有 CERT_KEY_PROV_INFO_PROP_ID 或 CERT_KEY_CONTEXT_PROP_ID 属性。

要求

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