CryptSignAndEncryptMessage 函数 (wincrypt.h)

CryptSignAndEncryptMessage 函数创建指定内容的哈希、对哈希进行签名、加密内容、对加密内容和已签名哈希进行哈希处理，然后对加密内容和已签名哈希进行编码。 结果与先对哈希进行签名后再加密时的结果相同。

语法

BOOL CryptSignAndEncryptMessage(
  [in]      PCRYPT_SIGN_MESSAGE_PARA    pSignPara,
  [in]      PCRYPT_ENCRYPT_MESSAGE_PARA pEncryptPara,
  [in]      DWORD                       cRecipientCert,
  [in]      PCCERT_CONTEXT []           rgpRecipientCert,
  [in]      const BYTE                  *pbToBeSignedAndEncrypted,
  [in]      DWORD                       cbToBeSignedAndEncrypted,
  [out]     BYTE                        *pbSignedAndEncryptedBlob,
  [in, out] DWORD                       *pcbSignedAndEncryptedBlob
);

参数

[in] pSignPara

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

[in] pEncryptPara

指向包含加密参数 的CRYPT_ENCRYPT_MESSAGE_PARA 结构的指针。

[in] cRecipientCert

rgpRecipientCert 中的数组元素数。

[in] rgpRecipientCert

指向 CERT_CONTEXT 结构的指针数组。 每个结构都是邮件的目标收件人的证书。

[in] pbToBeSignedAndEncrypted

指向包含要签名和加密的内容的缓冲区的指针。

[in] cbToBeSignedAndEncrypted

pbToBeSignedAndEncrypted 缓冲区的大小（以字节为单位）。

[out] pbSignedAndEncryptedBlob

指向用于接收加密和编码消息的缓冲区的指针。

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

[in, out] pcbSignedAndEncryptedBlob

指向 DWORD 的指针，指定 pbSignedAndEncryptedBlob 指向的缓冲区的大小（以字节为单位）。 函数返回时，此变量包含复制到 *pbSignedAndEncryptedBlob 的已签名和加密消息的大小（以字节为单位）。

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

 

返回值

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

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

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

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

返回代码	说明
ERROR_MORE_DATA	如果 pbSignedAndEncryptedBlob 参数指定的缓冲区不够大，无法容纳返回的数据，则函数将设置ERROR_MORE_DATA代码，并将所需的缓冲区大小（以字节为单位）存储到 由印刷板符号AndEncryptedBlob 指向的变量中。

 

注意 来自调用函数 CryptSignMessage 和 CryptEncryptMessage 的错误可能会传播到此函数。

 

要求

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

另请参阅

CryptDecryptAndVerifyMessageSignature

CryptSignMessage

简化的消息函数