struttura CMSG_MAIL_LIST_ENCRYPT_INFO (wincrypt.h)

La struttura CMSG_MAIL_LIST_ENCRYPT_INFO contiene informazioni di crittografia per un destinatario della lista di distribuzione dei dati in busta. La funzione PFN_CMSG_EXPORT_MAIL_LIST aggiorna questa struttura.

Sintassi

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;

Membri

cbSize

Dimensione, in byte, di questa struttura.

dwRecipientIndex

Valore che specifica il numero ordinale di un destinatario nell'elenco dei destinatari specificato dal parametro pContentEncryptInfo alla funzione PFN_CMSG_EXPORT_MAIL_LIST.

KeyEncryptionAlgorithm

Struttura CRYPT_ALGORITHM_IDENTIFIER che specifica l'algoritmo utilizzato per crittografare la chiave di crittografia del contenuto. La funzione CryptMsgOpenToEncode usa la funzione pszObjId membro della struttura CRYPT_ALGORITHM_IDENTIFIER per ottenere l'indirizzo della funzione usata per esportare la chiave. La funzione può essere installata usando un'API di crittografia: Next Generation (CNG) identificatore di oggetto (OID).

EncryptedKey

Struttura CRYPT_DATA_BLOB che contiene la chiave di sessione crittografata.

dwFlags

Valore che specifica quali membri sono stati aggiornati e la cui allocazione di memoria deve essere liberata usando la funzione CryptMsgOpenToEncode.

Osservazioni

Quando viene chiamato con il parametro dwMsgType impostato su CMSG_ENVELOPED, la funzione CryptMsgOpenToEncode inizializza la struttura CMSG_MAIL_LIST_ENCRYPT_INFO dalla struttura CMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO. La funzione CryptMsgOpenToEncode chiama la funzione PFN_CMSG_EXPORT_MAIL_LIST per aggiornare la struttura CMSG_MAIL_LIST_ENCRYPT_INFO. Se non è possibile trovare la funzione di callback, la funzione CryptMsgOpenToEncode riempie questa struttura con informazioni sulla chiave predefinite della struttura CMSG_CONTENT_ENCRYPT_INFO.

I membri seguenti della struttura CMSG_MAIL_LIST_ENCRYPT_INFO possono essere aggiornati dalla funzione di callback:

EncryptedKey

KeyEncryptionAlgorithm.pszObjId

KeyEncryptionAlgorithm.Parameters

dwFlags

Gli altri membri sono di sola lettura.

Fabbisogno

Vedere anche

di dati con codifica in busta