Información general sobre las propiedades del mensaje
Hace referencia a: Outlook 2013 | Outlook 2016
MAPI divide las propiedades del mensaje en tres tipos:
Propiedades de contenido del mensaje.
Propiedades de transmisión de mensajes o sobre.
Propiedades del destinatario del mensaje.
Las propiedades de contenido del mensaje describen el texto de un mensaje. Cada clase de mensaje tiene su propio conjunto de propiedades de contenido. MAPI define las propiedades de contenido para los mensajes de nota e informe; depende de los clientes y proveedores del almacén de mensajes que controlan estas clases de mensajes establecer las propiedades adecuadamente para sus implementaciones. PR_BODY (PidTagBody) y PR_RTF_COMPRESSED (PidTagRtfCompressed) son ejemplos de propiedades de contenido para los mensajes de nota. PR_BODY contiene el contenido sin formato de una nota, mientras que PR_RTF_COMPRESSED contiene la versión comprimida del contenido con formato de una nota. Para obtener más información sobre los intervalos de identificadores de propiedad, vea Intervalos de identificador de propiedad.
Para las nuevas clases de mensajes, los clientes pueden definir propiedades específicas del contenido de una de estas dos maneras:
Mediante el uso de identificadores de propiedad en el intervalo de propiedades de contenido de clase de mensaje personalizado: 0x6800 a través de 0x7BFF.
Mediante el uso de propiedades con nombre que tienen identificadores que se encuentran en el 0x8000 a través de 0xFFFE intervalo.
El intervalo de identificadores de las propiedades de contenido de clase de mensaje personalizado está disponible para cualquier cliente que cree una clase de mensaje personalizada. Por lo tanto, se puede usar un identificador de propiedad en este intervalo para varias clases de mensaje. Los usuarios de propiedades de este intervalo no pueden hacer suposiciones sobre el comportamiento de las propiedades.
Para las propiedades con nombre, los clientes crean un nombre que especifica un conjunto de propiedades y una cadena de caracteres o un valor numérico para cada nueva propiedad. A continuación, los clientes asocian la propiedad a un identificador en el intervalo de propiedades con nombre. Los usuarios de propiedades con nombre acceden a ellas por nombre o identificador a través de los métodos IMAPIProp::GetIDsFromNames e IMAPIProp::GetNamesFromIDs .
Las propiedades de sobre proporcionan información que se usa para transmitir un mensaje de un destinatario a otro. Al igual que con las propiedades de contenido del mensaje, es posible que los clientes o proveedores de servicios definan sus propias propiedades de sobre para complementar las que define MAPI. Los clientes y proveedores de transporte establecen las propiedades de sobre que MAPI define en función de la definición que proporciona MAPI. Los proveedores de transporte que implementan características especiales pueden definir sus propias propiedades de sobre para exponer esas características a los clientes. MAPI reserva un intervalo de identificadores de propiedad que se pueden usar para estas propiedades especiales definidas por el proveedor. Los proveedores de transporte suelen implementar una página de propiedades especial para mostrar estas propiedades y permitir que los clientes las cambien. PR_SUBJECT (PidTagSubject) y PR_MESSAGE_CLASS (PidTagMessageClass) son ejemplos de propiedades de sobre. Para obtener más información, vea Intervalos de identificadores de propiedad.
Las propiedades de destinatario describen el destino de un mensaje enviado. Un destinatario puede ser un usuario de mensajería, una lista de distribución o un equipo. Las propiedades de destinatario se definen mediante MAPI y las establecen los proveedores de servicios. Algunos proveedores de libretas de direcciones admiten algunas propiedades de destinatario para sus objetos de lista de distribución y usuario de mensajería; otras propiedades de destinatario son compatibles con clientes, proveedores de almacén de mensajes o proveedores de transporte. Por ejemplo, todos los destinatarios requieren una dirección y un tipo de dirección; estas son propiedades mantenidas por un proveedor de libreta de direcciones cuando el destinatario se almacena en uno de sus contenedores. Los destinatarios también tienen un tipo, PR_RECIPIENT_TYPE (PidTagRecipientType), que identifica a un destinatario como destinatario principal, copia de carbono o destinatario de copia de carbono ciego.
Muchas propiedades de mensaje son opcionales, lo que significa que los clientes no pueden esperar que estén disponibles o establecidas en valores válidos. Algunas propiedades de mensaje son necesarias, pero solo están disponibles cuando un mensaje está en un estado determinado. Por ejemplo, no es necesario que un mensaje recién creado tenga un identificador de entrada hasta que se haya guardado el mensaje y no es necesario tener una clase de mensaje hasta que el mensaje esté listo para enviarse. Los clientes siempre deben comprobar los resultados de sus llamadas IMAPIProp::GetProps e IMAPIProp::OpenProperty y tener valores predeterminados listos como copia de seguridad en caso de que una propiedad solicitada no esté disponible.
La mayoría de las propiedades de mensaje que establecen los proveedores de servicios son de solo lectura para los clientes.