CMSG_KEY_AGREE_RECIPIENT_INFO structure (wincrypt.h)

La structure CMSG_KEY_AGREE_RECIPIENT_INFO contient des informations utilisées pour les algorithmes d’accord de clé.

Syntaxe

typedef struct _CMSG_KEY_AGREE_RECIPIENT_INFO {
  DWORD                              dwVersion;
  DWORD                              dwOriginatorChoice;
  union {
    CERT_ID              OriginatorCertId;
    CERT_PUBLIC_KEY_INFO OriginatorPublicKeyInfo;
  } DUMMYUNIONNAME;
  CRYPT_DATA_BLOB                    UserKeyingMaterial;
  CRYPT_ALGORITHM_IDENTIFIER         KeyEncryptionAlgorithm;
  DWORD                              cRecipientEncryptedKeys;
  PCMSG_RECIPIENT_ENCRYPTED_KEY_INFO *rgpRecipientEncryptedKeys;
} CMSG_KEY_AGREE_RECIPIENT_INFO, *PCMSG_KEY_AGREE_RECIPIENT_INFO;

Membres

dwVersion

DWORD qui indique la version de la structure. Toujours défini sur trois.

dwOriginatorChoice

DWORD qui indique l’identificateur de clé à utiliser.

Ce membre peut être l’une des valeurs suivantes.

Valeur	Signification
CMSG_KEY_AGREE_ORIGINATOR_CERT	OriginatorCertId
CMSG_KEY_AGREE_ORIGINATOR_PUBLIC_KEY	OriginatorPublicKeyInfo

DUMMYUNIONNAME

DUMMYUNIONNAME.OriginatorCertId

CERT_ID qui identifie la clé publique de l’expéditeur de message.

DUMMYUNIONNAME.OriginatorPublicKeyInfo

Structure CERT_PUBLIC_KEY_INFO qui contient la clé publique de l’initiateur de message.

UserKeyingMaterial

CRYPT_DATA_BLOB qui indique qu’une clé différente est générée chaque fois que les deux mêmes parties génèrent une paire de clés. L’expéditeur fournit les bits de cet objet BLOB avec des algorithmes d’accord clés. Ce membre peut être NULL.

KeyEncryptionAlgorithm

Un CRYPT_ALGORITHM_IDENTIFIER qui identifie l’algorithme de chiffrement de clé et tous les paramètres associés utilisés pour chiffrer la clé de chiffrement de contenu.

cRecipientEncryptedKeys

Nombre d’éléments dans le tableau rgpRecipientEncryptedKeys .

rgpRecipientEncryptedKeys

Adresse d’un tableau de structures CMSG_RECIPIENT_ENCRYPTED_KEY_INFO qui contient des informations sur les destinataires de clé. Le membre cRecipientEncryptedKeys contient le nombre d’éléments dans ce tableau.

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