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 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 a 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 pszObjId miembro de la estructura de CRYPT_ALGORITHM_IDENTIFIER para obtener la dirección de la función utilizada para exportar la clave. La función se puede instalar mediante cryptography API: Next Generation (CNG) identificador de objeto (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 debe liberarse 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 miembropb Data parameters de la estructura CRYPT_ALGORITHM_IDENTIFIER a la que hace referencia el miembro KeyEncryptionAlgorithm.

Observaciones

Cuando se llama con el parámetro dwMsgType de 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 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 CMSG_MAIL_LIST_ENCRYPT_INFO:

EncryptedKey

KeyEncryptionAlgorithm.pszObjId

KeyEncryptionAlgorithm.Parameters

dwFlags

Los demás miembros son de solo lectura.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
encabezado de	wincrypt.h

Consulte también

codificación de datos sobres