Clases de mensajes MAPI
Hace referencia a: Outlook 2013 | Outlook 2016
Cada mensaje tiene una propiedad de clase de mensaje, PR_MESSAGE_CLASS (PidTagMessageClass), que identifica el tipo, el propósito o el contenido del mensaje. PR_MESSAGE_CLASS es una propiedad necesaria en todos los mensajes nuevos. La clase de un mensaje determina el formulario que se usa para presentar el mensaje al usuario y la carpeta para colocar los mensajes entrantes.
Las clases de mensaje son cadenas de caracteres que distinguen mayúsculas de minúsculas que contienen caracteres ASCII de 32 a 127 y están delimitadas por puntos, pero no pueden terminar con un punto. Cada cadena representa un nivel de subclases y no hay ningún límite en el número de niveles permitidos.
Por ejemplo, la mayoría de los mensajes que las aplicaciones cliente envían y reciben pertenecen a la clase de mensajes IPM , una categoría amplia que describe todos los mensajes de tipo booleano (es decir, los mensajes que un usuario humano debe leer, en lugar de ser leídos mediante programación por un equipo). Los proveedores de almacén de mensajes describen con más precisión un mensaje IPM mediante la creación de una subclase IPM . La subclase IPM hereda las propiedades de la clase de mensaje IPM . Las subclases de la clase IPM se denominan concatenando otras cadenas de caracteres en el identificador IPM, como IPM. Nota para describir un mensaje de nota y un IPM. Contacto para describir un mensaje de contacto.
Para controlar la presentación y administración de mensajes IPM, los clientes pueden usar un formulario estándar que proporciona MAPI. Para controlar la presentación y administración de nuevas clases de mensajes, como desarrollador de aplicaciones cliente tiene dos opciones:
Puede crear un nuevo formulario mediante el conjunto de interfaces de formulario definidas por MAPI que un cliente estándar puede usar.
Puede escribir su propio cliente implementando una aplicación completa e independiente.
Aunque los clientes deben establecer la propiedad PR_MESSAGE_CLASS de cada mensaje saliente en una subclase de IPM o IPC, el proveedor del almacén de mensajes tiene la responsabilidad final de configurarlo. Por lo tanto, si un cliente envía un mensaje sin establecer su clase de mensaje, el proveedor del almacén de mensajes lo establece en el valor predeterminado adecuado para el tipo de cliente adecuado. La clase de mensaje predeterminada para los clientes de mensajería de tipo de datos es IPM; la clase de mensaje predeterminada para los clientes de comunicación entre procesos es IPC.
Las clases de mensaje tienen una restricción de longitud de 255 caracteres. Sin embargo, las clases de mensaje no deben superar los 127 caracteres para admitir las clases de mensaje usadas en los informes. Las clases de mensaje de informe se basan en la clase del mensaje original, con dos adiciones: un prefijo y un sufijo. El prefijo REPORT indica que el mensaje es un informe y el sufijo indica el tipo de informe: DR (informe de entrega), NDR (informe no entregado), IPNRN (informe de lectura) o IPNNRN (informe no leído). Tenga en cuenta que estas restricciones de longitud se proporcionan en caracteres; en las plataformas que usan un juego de caracteres de doble byte, el recuento de bytes real podría ser mayor.
Los proveedores de almacén de mensajes deben devolver MAPI_E_INVALID_PARAMETER de sus implementaciones de método IMAPIProp::SetProps cuando un cliente intenta asignar una cadena que supera el límite permitido para su clase de mensaje.