structure CMSG_CTRL_KEY_AGREE_DECRYPT_PARA (wincrypt.h)

La structure CMSG_CTRL_KEY_AGREE_DECRYPT_PARA contient des informations sur un destinataire de contrat clé.

Syntaxe

typedef struct _CMSG_CTRL_KEY_AGREE_DECRYPT_PARA {
  DWORD                          cbSize;
  union {
    HCRYPTPROV        hCryptProv;
    NCRYPT_KEY_HANDLE hNCryptKey;
  } DUMMYUNIONNAME;
  DWORD                          dwKeySpec;
  PCMSG_KEY_AGREE_RECIPIENT_INFO pKeyAgree;
  DWORD                          dwRecipientIndex;
  DWORD                          dwRecipientEncryptedKeyIndex;
  CRYPT_BIT_BLOB                 OriginatorPublicKey;
} CMSG_CTRL_KEY_AGREE_DECRYPT_PARA, *PCMSG_CTRL_KEY_AGREE_DECRYPT_PARA;

Membres

cbSize

Taille, en octets, de cette structure de données.

DUMMYUNIONNAME

DUMMYUNIONNAME.hCryptProv

Handle du fournisseur de services de chiffrement (CSP) utilisé pour effectuer le chiffrement et l’exportation de la clé de destinataire. Si la valeur est NULL, le fournisseur spécifié dans CMSG_ENVELOPED_ENCODE_INFO est utilisé. La fonction CNG NCryptIsKeyHandle est appelée pour déterminer le choix d’union.

DUMMYUNIONNAME.hNCryptKey

Handle du fournisseur de solutions cloud CNG utilisé pour effectuer le chiffrement et l’exportation de la clé de destinataire. La fonction CNG NCryptIsKeyHandle est appelée pour déterminer le choix d’union. Les nouveaux algorithmes de chiffrement sont uniquement pris en charge dans les fonctions CNG. La fonction CNG NCryptTranslateHandle sera appelée pour convertir le choix du csp CryptoAPI hCryptProv si nécessaire. Nous recommandons aux applications de transmettre au membre hNCryptKey le handle CSP CNG retourné par la fonction NCryptOpenKey .

dwKeySpec

Spécifie la clé chiffrée. La clé chiffrée est le résultat du chiffrement de la clé de chiffrement de contenu. Ce membre n’est pas utilisé lorsque le membre hNCryptKey est utilisé.

pKeyAgree

Pointeur vers une structure CMSG_KEY_AGREE_RECIPIENT_INFO .

dwRecipientIndex

Indique un destinataire spécifique dans un tableau de destinataires.

dwRecipientEncryptedKeyIndex

Indique une clé chiffrée spécifique dans un tableau de clés chiffrées.

OriginatorPublicKey

Une structure CRYPT_BIT_BLOB qui contient les informations de clé publique de l’expéditeur.

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