Compartir a través de

Creación de una lista de destinatarios

  • Artículo

Hace referencia a: Outlook 2013 | Outlook 2016

Una lista de destinatarios es una estructura ADRLIST que contiene una matriz de estructuras de valor de propiedad para cada destinatario del mensaje: destino del mensaje. Un destinatario puede representar un usuario humano, una máquina o una carpeta. Todos los mensajes que se van a enviar requieren al menos un destinatario que haya pasado por el proceso de resolución de nombres, un proceso para garantizar que la propiedad PR_ENTRYID (PidTagEntryId) se incluya en la matriz de valores de propiedad del destinatario.

Las propiedades de un destinatario son una combinación de propiedades de libreta de direcciones y propiedades de mensaje. Las propiedades de destinatario se pueden aplicar a todos los mensajes de un destinatario determinado o solo al mensaje actual. Tanto el almacén de mensajes como los proveedores de transporte pueden establecer propiedades de destinatario.

Cada destinatario debe tener un conjunto principal de propiedades en su matriz de valores de propiedad para el momento en que el mensaje esté listo para enviarse. El conjunto necesario de propiedades de destinatario incluye:

Estas propiedades se usan para acceder al destinatario, enviarle mensajes y compararlos con otros usuarios. No todas estas propiedades deben estar disponibles de inmediato. Puede agregar un destinatario inicialmente sin conocer su identificador de entrada, basándose en el proceso de resolución de nombres para asignar esta propiedad. En algún momento antes de enviar un mensaje, llame a IAddrBook::ResolveName para asegurarse de que se resuelvan todos los destinatarios de la lista de destinatarios. Para obtener más información, consulte Resolución de un nombre de destinatario.

Las listas de destinatarios se pueden crear a partir de entradas de lista de distribución o de usuarios de mensajería en un contenedor de libreta de direcciones o de un solo usuario. Las ventajas únicas son los destinatarios que se crean como entradas temporales que se van a usar solo para abordar un único mensaje o como entradas que se van a agregar a una libreta de direcciones personal. MAPI define el formato de un identificador de entrada único y una dirección. Para obtener más información sobre estos formatos, vea Direcciones de uso único e Identificadores de entrada de un solo uso.

Puede permitir que los usuarios compilen sus listas de destinatarios:

  • Solo con entradas de la libreta de direcciones.

  • Solo con entradas únicas.

  • Con una combinación de destinatarios de la libreta de direcciones y ventajas únicas.

Para crear una lista de destinatarios mediante el cuadro de diálogo de dirección común

  1. Asigne una estructura ADRPARM y un puntero a una estructura ADRLIST .

  2. Cero la memoria de la estructura ADRPARM y establezca el puntero ADRLIST en NULL.

  3. Llame a IAddrBook::Address para mostrar el cuadro de diálogo de dirección y rellenar la estructura ADRPARM .

  4. Llame a IMessage::ModifyRecipients y pase el puntero ADRLIST . Esta estructura contendrá las propiedades de cada uno de los destinatarios seleccionados por el usuario.

Para crear una lista de destinatarios mediante programación

  1. Asigne una estructura ADRLIST que contenga una estructura ADRENTRY para cada uno de los destinatarios que se incluirán en la lista. Haga que cada estructura ADRENTRY sea lo suficientemente grande como para contener cada una de las propiedades necesarias y PR_RECIPIENT_TYPE (PidTagRecipientType).

  2. Para cada destinatario, establezca la matriz de valores de propiedad para su miembro aEntries en la estructura ADRLIST .

  3. Llame a IMessage::ModifyRecipients con la marca MODRECIP_ADD establecida.