CMSG_MAIL_LIST_ENCRYPT_INFO structure (wincrypt.h)

Article
03/15/2023

La structure CMSG_MAIL_LIST_ENCRYPT_INFO contient des informations de chiffrement pour un destinataire de liste de diffusion de données enveloppées. La fonction PFN_CMSG_EXPORT_MAIL_LIST met à jour cette structure.

Syntaxe

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;

Membres

cbSize

Taille, en octets, de cette structure.

dwRecipientIndex

Valeur qui spécifie le numéro ordinal d’un destinataire dans la liste de destinataires spécifiée par le paramètre pContentEncryptInfo à la fonction PFN_CMSG_EXPORT_MAIL_LIST .

KeyEncryptionAlgorithm

Structure CRYPT_ALGORITHM_IDENTIFIER qui spécifie l’algorithme utilisé pour chiffrer la clé de chiffrement de contenu. La fonction CryptMsgOpenToEncode utilise le membre pszObjId de la structure CRYPT_ALGORITHM_IDENTIFIER pour obtenir l’adresse de la fonction utilisée pour exporter la clé. La fonction peut être installée à l’aide d’une API de chiffrement : identificateur d’objet (OID) CNG (Next Generation).

EncryptedKey

Structure CRYPT_DATA_BLOB qui contient la clé de session chiffrée.

dwFlags

Valeur qui spécifie les membres qui ont été mis à jour et dont l’allocation de mémoire doit être libérée à l’aide de la fonction CryptMsgOpenToEncode .

Valeur	Signification
CMSG_MAIL_LIST_ENCRYPT_FREE_OBJID_FLAG 0x00000002	Le membre pszObjId de la structure CRYPT_ALGORITHM_IDENTIFIER référencée par le membre KeyEncryptionAlgorithm a été mis à jour.
CMSG_MAIL_LIST_ENCRYPT_FREE_PARA_FLAG 0x00000001	Le membre ParameterspbData de la structure CRYPT_ALGORITHM_IDENTIFIER référencée par le membre KeyEncryptionAlgorithm a été mis à jour.

Remarques

Lorsqu’elle est appelée avec le paramètre dwMsgType défini sur CMSG_ENVELOPED, la fonction CryptMsgOpenToEncode initialise la structure CMSG_MAIL_LIST_ENCRYPT_INFO à partir de la structure CMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO . La fonction CryptMsgOpenToEncode appelle la fonction PFN_CMSG_EXPORT_MAIL_LIST pour mettre à jour la structure CMSG_MAIL_LIST_ENCRYPT_INFO . Si la fonction de rappel est introuvable, la fonction CryptMsgOpenToEncode remplit cette structure avec les informations de clé par défaut de la structure CMSG_CONTENT_ENCRYPT_INFO .

Les membres suivants de la structure CMSG_MAIL_LIST_ENCRYPT_INFO peuvent être mis à jour par la fonction de rappel :

Encryptedkey

KeyEncryptionAlgorithm.pszObjId

KeyEncryptionAlgorithm.Parameters

dwFlags

Les autres membres sont en lecture seule.

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	wincrypt.h

Voir aussi

Encodage des données enveloppées