Skip to content

Latest commit

 

History

History
126 lines (101 loc) · 5.99 KB

ns-wincrypt-cmsg_mail_list_encrypt_info.md

File metadata and controls

126 lines (101 loc) · 5.99 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NS:wincrypt._CMSG_MAIL_LIST_ENCRYPT_INFO
CMSG_MAIL_LIST_ENCRYPT_INFO (wincrypt.h)
Contains encryption information for a mailing list recipient of enveloped data.
*PCMSG_MAIL_LIST_ENCRYPT_INFO
CMSG_MAIL_LIST_ENCRYPT_FREE_OBJID_FLAG
CMSG_MAIL_LIST_ENCRYPT_FREE_PARA_FLAG
CMSG_MAIL_LIST_ENCRYPT_INFO
CMSG_MAIL_LIST_ENCRYPT_INFO structure [Security]
PCMSG_MAIL_LIST_ENCRYPT_INFO
PCMSG_MAIL_LIST_ENCRYPT_INFO structure pointer [Security]
security.cmsg_mail_list_encrypt_info
wincrypt/CMSG_MAIL_LIST_ENCRYPT_INFO
wincrypt/PCMSG_MAIL_LIST_ENCRYPT_INFO
security\cmsg_mail_list_encrypt_info.htm
security
25c4338a-1ea3-4fff-a6bf-f3884a8154d3
12/05/2018
*PCMSG_MAIL_LIST_ENCRYPT_INFO, CMSG_MAIL_LIST_ENCRYPT_FREE_OBJID_FLAG, CMSG_MAIL_LIST_ENCRYPT_FREE_PARA_FLAG, CMSG_MAIL_LIST_ENCRYPT_INFO, CMSG_MAIL_LIST_ENCRYPT_INFO structure [Security], PCMSG_MAIL_LIST_ENCRYPT_INFO, PCMSG_MAIL_LIST_ENCRYPT_INFO structure pointer [Security], security.cmsg_mail_list_encrypt_info, wincrypt/CMSG_MAIL_LIST_ENCRYPT_INFO, wincrypt/PCMSG_MAIL_LIST_ENCRYPT_INFO
wincrypt.h
Windows
Windows XP [desktop apps only]
Windows Server 2003 [desktop apps only]
Windows
CMSG_MAIL_LIST_ENCRYPT_INFO, *PCMSG_MAIL_LIST_ENCRYPT_INFO
19H1
_CMSG_MAIL_LIST_ENCRYPT_INFO
wincrypt/_CMSG_MAIL_LIST_ENCRYPT_INFO
PCMSG_MAIL_LIST_ENCRYPT_INFO
wincrypt/PCMSG_MAIL_LIST_ENCRYPT_INFO
CMSG_MAIL_LIST_ENCRYPT_INFO
wincrypt/CMSG_MAIL_LIST_ENCRYPT_INFO
c++
APIRef
kbSyntax
HeaderDef
Wincrypt.h
CMSG_MAIL_LIST_ENCRYPT_INFO

CMSG_MAIL_LIST_ENCRYPT_INFO structure

-description

The CMSG_MAIL_LIST_ENCRYPT_INFO structure contains encryption information for a mailing list recipient of enveloped data. The PFN_CMSG_EXPORT_MAIL_LIST function updates this structure.

-struct-fields

-field cbSize

The size, in bytes, of this structure.

-field dwRecipientIndex

A value that specifies the ordinal number of a recipient in the recipient list specified by the pContentEncryptInfo parameter to the PFN_CMSG_EXPORT_MAIL_LIST function.

-field KeyEncryptionAlgorithm

A CRYPT_ALGORITHM_IDENTIFIER structure that specifies the algorithm used to encrypt the content encryption key. The CryptMsgOpenToEncode function uses the pszObjId member of the CRYPT_ALGORITHM_IDENTIFIER structure to get the address of the function used to export the key. The function can be installed by using a Cryptography API: Next Generation (CNG) object identifier (OID).

-field EncryptedKey

A CRYPT_DATA_BLOB structure that contains the encrypted session key.

-field dwFlags

A value that specifies what members have been updated, and whose memory allocation must be freed by using the CryptMsgOpenToEncode function.

Value Meaning
CMSG_MAIL_LIST_ENCRYPT_FREE_OBJID_FLAG
0x00000002
The pszObjId member of the CRYPT_ALGORITHM_IDENTIFIER structure referred to by the KeyEncryptionAlgorithm member was updated.
CMSG_MAIL_LIST_ENCRYPT_FREE_PARA_FLAG
0x00000001
The Parameters pbData member of the CRYPT_ALGORITHM_IDENTIFIER structure referred to by the KeyEncryptionAlgorithm member was updated.

-remarks

When called with the dwMsgType parameter set to CMSG_ENVELOPED, the CryptMsgOpenToEncode function initializes the CMSG_MAIL_LIST_ENCRYPT_INFO structure from the CMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO structure. The CryptMsgOpenToEncode function calls the PFN_CMSG_EXPORT_MAIL_LIST function to update the CMSG_MAIL_LIST_ENCRYPT_INFO structure. If the callback function cannot be found, the CryptMsgOpenToEncode function fills this structure with default key information from the CMSG_CONTENT_ENCRYPT_INFO structure.

The following members of the CMSG_MAIL_LIST_ENCRYPT_INFO structure can be updated by the callback function:

EncryptedKey
KeyEncryptionAlgorithm.pszObjId
KeyEncryptionAlgorithm.Parameters
dwFlags

The other members are read-only.

-see-also

Encoding Enveloped Data