estructura CMSG_MAIL_LIST_ENCRYPT_INFO (wincrypt.h)

La estructura CMSG_MAIL_LIST_ENCRYPT_INFO contiene información de cifrado para un destinatario de la lista de distribución de correo de datos sobres. La función PFN_CMSG_EXPORT_MAIL_LIST actualiza esta estructura.

Sintaxis

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;

Miembros

cbSize

Tamaño, en bytes, de esta estructura.

dwRecipientIndex

Valor que especifica el número ordinal de un destinatario en la lista de destinatarios especificado por el parámetro pContentEncryptInfo para la función PFN_CMSG_EXPORT_MAIL_LIST .

KeyEncryptionAlgorithm

Estructura CRYPT_ALGORITHM_IDENTIFIER que especifica el algoritmo utilizado para cifrar la clave de cifrado de contenido. La función CryptMsgOpenToEncode usa el miembro pszObjId de la estructura CRYPT_ALGORITHM_IDENTIFIER para obtener la dirección de la función utilizada para exportar la clave. La función se puede instalar mediante un identificador de objeto de Cryptography API: Next Generation (CNG) (OID).

EncryptedKey

Estructura CRYPT_DATA_BLOB que contiene la clave de sesión cifrada.

dwFlags

Valor que especifica qué miembros se han actualizado y cuya asignación de memoria se debe liberar mediante la función CryptMsgOpenToEncode .

Valor	Significado
CMSG_MAIL_LIST_ENCRYPT_FREE_OBJID_FLAG 0x00000002	Se actualizó el miembro pszObjId de la estructura CRYPT_ALGORITHM_IDENTIFIER a la que hace referencia el miembro KeyEncryptionAlgorithm .
CMSG_MAIL_LIST_ENCRYPT_FREE_PARA_FLAG 0x00000001	Se actualizó el miembro pbDataparameters de la estructura de CRYPT_ALGORITHM_IDENTIFIER a la que hace referencia el miembro KeyEncryptionAlgorithm.

Comentarios

Cuando se llama con el parámetro dwMsgType establecido en CMSG_ENVELOPED, la función CryptMsgOpenToEncode inicializa la estructura CMSG_MAIL_LIST_ENCRYPT_INFO de la estructura CMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO . La función CryptMsgOpenToEncode llama a la función PFN_CMSG_EXPORT_MAIL_LIST para actualizar la estructura de CMSG_MAIL_LIST_ENCRYPT_INFO . Si no se encuentra la función de devolución de llamada, la función CryptMsgOpenToEncode rellena esta estructura con información de clave predeterminada de la estructura CMSG_CONTENT_ENCRYPT_INFO .

La función de devolución de llamada puede actualizar los siguientes miembros de la estructura de CMSG_MAIL_LIST_ENCRYPT_INFO :

EncryptedKey

KeyEncryptionAlgorithm.pszObjId

KeyEncryptionAlgorithm.Parameters

dwFlags

Los demás miembros son de solo lectura.

Requisitos

Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	wincrypt.h

Consulte también

Codificación de datos sobres