CMSG_KEY_TRANS_ENCRYPT_INFO structure (wincrypt.h)

Article
08/27/2023

La structure CMSG_KEY_TRANS_ENCRYPT_INFO contient des informations de chiffrement pour un destinataire de transport de clé de données enveloppées. La fonction PFN_CMSG_EXPORT_KEY_TRANS met à jour cette structure.

Syntaxe

typedef struct _CMSG_KEY_TRANS_ENCRYPT_INFO {
  DWORD                      cbSize;
  DWORD                      dwRecipientIndex;
  CRYPT_ALGORITHM_IDENTIFIER KeyEncryptionAlgorithm;
  CRYPT_DATA_BLOB            EncryptedKey;
  DWORD                      dwFlags;
} CMSG_KEY_TRANS_ENCRYPT_INFO, *PCMSG_KEY_TRANS_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 des destinataires spécifiée par le paramètre pContentEncryptInfo de la fonction PFN_CMSG_EXPORT_KEY_TRANS .

KeyEncryptionAlgorithm

Structure CRYPT_ALGORITHM_IDENTIFIER qui spécifie l’algorithme de la clé publique du destinataire. 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 par la clé publique du destinataire.

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_KEY_TRANS_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_KEY_TRANS_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_KEY_TRANS_ENCRYPT_INFO à partir de la structure CMSG_KEY_TRANS_RECIPIENT_ENCODE_INFO . La fonction CryptMsgOpenToEncode appelle la fonction PFN_CMSG_EXPORT_KEY_TRANS pour mettre à jour la structure CMSG_KEY_TRANS_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_KEY_TRANS_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

Condition requise	Valeur
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

Partager via