struttura CMSG_KEY_AGREE_RECIPIENT_INFO (wincrypt.h)

La struttura CMSG_KEY_AGREE_RECIPIENT_INFO contiene informazioni utilizzate per gli algoritmi di contratto chiave.

Sintassi

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;

Members

dwVersion

DWORD che indica la versione della struttura. Impostare sempre su tre.

dwOriginatorChoice

DWORD che indica l'identificatore di chiave da usare.

Questo membro può essere uno dei valori seguenti.

Valore	Significato
CMSG_KEY_AGREE_ORIGINATOR_CERT	OriginatorCertId
CMSG_KEY_AGREE_ORIGINATOR_PUBLIC_KEY	OriginatorPublicKeyInfo

DUMMYUNIONNAME

DUMMYUNIONNAME.OriginatorCertId

Un CERT_ID che identifica la chiave pubblica dell'originatore del messaggio.

DUMMYUNIONNAME.OriginatorPublicKeyInfo

Struttura CERT_PUBLIC_KEY_INFO che contiene la chiave pubblica dell'originatore del messaggio.

UserKeyingMaterial

Un CRYPT_DATA_BLOB che indica che viene generata una chiave diversa ogni volta che le stesse due parti generano una coppia di chiavi. Il mittente fornisce i bit di questo BLOB con alcuni algoritmi di contratto chiave. Questo membro può essere NULL.

KeyEncryptionAlgorithm

Un CRYPT_ALGORITHM_IDENTIFIER che identifica l'algoritmo di crittografia della chiave e tutti i parametri associati usati per crittografare la chiave di crittografia del contenuto.

cRecipientEncryptedKeys

Numero di elementi nella matrice rgpRecipientEncryptedKeys .

rgpRecipientEncryptedKeys

Indirizzo di una matrice di strutture CMSG_RECIPIENT_ENCRYPTED_KEY_INFO che contiene informazioni sui destinatari della chiave. Il membro cRecipientEncryptedKeys contiene il numero di elementi in questa matrice.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	wincrypt.h