wincrypt.h) (CMSG_MAIL_LIST_ENCRYPT_INFO 结构

  • 项目

CMSG_MAIL_LIST_ENCRYPT_INFO 结构包含信封数据的邮件列表收件人的加密信息。 PFN_CMSG_EXPORT_MAIL_LIST 函数更新此结构。

语法

typedef struct _CMSG_MAIL_LIST_ENCRYPT_INFO {
  DWORD                      cbSize;
  DWORD                      dwRecipientIndex;
  CRYPT_ALGORITHM_IDENTIFIER KeyEncryptionAlgorithm;
  CRYPT_DATA_BLOB            EncryptedKey;
  DWORD                      dwFlags;
} CMSG_MAIL_LIST_ENCRYPT_INFO, *PCMSG_MAIL_LIST_ENCRYPT_INFO;

成员

cbSize

此结构的大小（以字节为单位）。

dwRecipientIndex

一个 值，该值指定PFN_CMSG_EXPORT_MAIL_LIST函数的pContentEncryptInfo 参数指定的收件人列表中的收件人的序号。

KeyEncryptionAlgorithm

指定用于加密内容加密密钥的算法 的CRYPT_ALGORITHM_IDENTIFIER 结构。 CryptMsgOpenToEncode 函数使用 CRYPT_ALGORITHM_IDENTIFIER 结构的 pszObjId 成员来获取用于导出密钥的函数的地址。 可以使用加密 API：下一代 (CNG) 对象标识符 (OID) 安装函数。

EncryptedKey

包含加密会话密钥 的CRYPT_DATA_BLOB 结构。

dwFlags

一个 值，该值指定哪些成员已更新，并且必须使用 CryptMsgOpenToEncode 函数释放其内存分配。

值 含义
CMSG_MAIL_LIST_ENCRYPT_FREE_OBJID_FLAG
0x00000002
 已更新由 KeyEncryptionAlgorithm 成员引用的 CRYPT_ALGORITHM_IDENTIFIER 结构的 pszObjId 成员。
CMSG_MAIL_LIST_ENCRYPT_FREE_PARA_FLAG
0x00000001
 已更新由 KeyEncryptionAlgorithm 成员引用的 CRYPT_ALGORITHM_IDENTIFIER 结构的 ParameterspbData 成员。

注解

在将 dwMsgType 参数设置为 CMSG_ENVELOPED 的情况下调用时， CryptMsgOpenToEncode 函数从 CMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO 结构初始化 CMSG_MAIL_LIST_ENCRYPT_INFO 结构。 CryptMsgOpenToEncode 函数调用 PFN_CMSG_EXPORT_MAIL_LIST 函数以更新 CMSG_MAIL_LIST_ENCRYPT_INFO 结构。 如果找不到回调函数， CryptMsgOpenToEncode 函数会用 来自 CMSG_CONTENT_ENCRYPT_INFO 结构的默认密钥信息填充此结构。

回调函数可以更新 CMSG_MAIL_LIST_ENCRYPT_INFO 结构的以下成员：

EncryptedKey
KeyEncryptionAlgorithm.pszObjId
KeyEncryptionAlgorithm.Parameters
dwFlags

其他成员是只读的。

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
标头 wincrypt.h

另请参阅

对信封数据进行编码