CryptEncryptMessage 函数 (wincrypt.h)

  • 项目

CryptEncryptMessage 函数对消息进行加密和编码。

语法

BOOL CryptEncryptMessage(
  [in]      PCRYPT_ENCRYPT_MESSAGE_PARA pEncryptPara,
  [in]      DWORD                       cRecipientCert,
  [in]      PCCERT_CONTEXT []           rgpRecipientCert,
  [in]      const BYTE                  *pbToBeEncrypted,
  [in]      DWORD                       cbToBeEncrypted,
  [out]     BYTE                        *pbEncryptedBlob,
  [in, out] DWORD                       *pcbEncryptedBlob
);

参数

[in] pEncryptPara

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

CryptEncryptMessage 函数不支持 SHA2 OID、szOID_DH_SINGLE_PASS_STDDH_SHA256_KDF和szOID_DH_SINGLE_PASS_STDDH_SHA384_KDF。

[in] cRecipientCert

rgpRecipientCert 数组中的元素数。

[in] rgpRecipientCert

指向包含邮件目标收件人证书 的CERT_CONTEXT 结构的指针数组。

[in] pbToBeEncrypted

指向包含要加密的消息的缓冲区的指针。

[in] cbToBeEncrypted

要加密的消息的大小（以字节为单位）。

[out] pbEncryptedBlob

指向 BLOB 的指针，该 BLOB 包含接收加密和编码消息的缓冲区。

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

[in, out] pcbEncryptedBlob

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

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

返回值

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

如果函数失败，则返回零 (FALSE) 。 有关扩展的错误信息，请调用 GetLastError。

注意 调用 CryptGenKey、 CryptEncrypt、 CryptImportKey 和 CryptExportKey 的错误可能会传播到此函数。
 
GetLastError 函数最常返回以下错误代码。
返回代码 说明
ERROR_MORE_DATA
 如果 pbEncryptedBlob 参数指定的缓冲区不够大，无法保存返回的数据，则函数将设置ERROR_MORE_DATA代码，并将所需的缓冲区大小（以字节为单位）存储在 由ERROR_MORE_DATA bEncryptedBlob指向的变量中。
E_INVALIDARG
 消息编码类型无效。 目前仅支持PKCS_7_ASN_ENCODING。 *pEncryptPara 中的 cbSize 无效。
 

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

要求

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

另请参阅

简化的消息函数