Propiedad canónica PidTagMessageFlags

Artículo
04/04/2023

Hace referencia a: Outlook 2013 | Outlook 2016

Contiene una máscara de bits de marcas que indican el origen y el estado actual de un mensaje.

Propiedad	Valor
Propiedades asociadas:	PR_MESSAGE_FLAGS
Identificador:	0x0E07
Tipo de datos:	PT_LONG
Área:	Mensajería general

Comentarios

Esta propiedad es una propiedad de mensaje no transmitible expuesta en los extremos de envío y recepción de una transmisión, con valores diferentes en función de la aplicación cliente o el proveedor de almacén implicados. El proveedor de cliente o almacén de mensajes inicializa esta propiedad cuando se crea y guarda un mensaje por primera vez y, a continuación, lo actualiza periódicamente el proveedor del almacén de mensajes, un proveedor de transporte y la cola MAPI a medida que se procesa el mensaje y cambia su estado.

Esta propiedad existe en un mensaje antes y después del envío, y en todas las copias del mensaje recibido. Aunque no es una propiedad de destinatario, se expone de forma diferente a cada destinatario en función de si ese destinatario la ha leído o modificado.

Se pueden establecer una o varias de las siguientes marcas para esta propiedad:

MSGFLAG_ASSOCIATED

El mensaje es un mensaje asociado de una carpeta. El cliente o proveedor tiene acceso de solo lectura a esta marca. La marca de MSGFLAG_READ se omite para los mensajes asociados, que no conservan un estado de lectura o no leído.

MSGFLAG_FROMME

El usuario de mensajería que envió fue el usuario de mensajería que recibió el mensaje. El cliente o proveedor tiene acceso de lectura y escritura a esta marca hasta la primera llamada a IMAPIProp::SaveChanges y de solo lectura a partir de entonces. Esta marca está pensada para que la establezca el proveedor de transporte.

MSGFLAG_HASATTACH

El mensaje tiene al menos un archivo adjunto. Esta marca corresponde a la propiedad PR_HASATTACH (PidTagHasAttachments) del mensaje. El cliente tiene acceso de solo lectura a esta marca.

MSGFLAG_NRN_PENDING

Se debe enviar un informe no leído para el mensaje. El cliente o proveedor tiene acceso de solo lectura a esta marca.

MSGFLAG_ORIGIN_INTERNET

El mensaje entrante llegó a través de Internet. Se originó fuera de la organización o de un origen que la puerta de enlace no puede considerar de confianza. El cliente debe mostrar un mensaje adecuado al usuario. Los proveedores de transporte establecen esta marca; el cliente tiene acceso de solo lectura.

MSGFLAG_ORIGIN_MISC_EXT

El mensaje entrante llegó a través de un vínculo externo distinto de X.400 o Internet. Se originó fuera de la organización o de un origen que la puerta de enlace no puede considerar de confianza. El cliente debe mostrar un mensaje adecuado al usuario. Los proveedores de transporte establecen esta marca; el cliente tiene acceso de solo lectura.

MSGFLAG_ORIGIN_X400

El mensaje entrante llegó a través de un vínculo X.400. Se originó fuera de la organización o de un origen que la puerta de enlace no puede considerar de confianza. El cliente debe mostrar un mensaje adecuado al usuario. Los proveedores de transporte establecen esta marca; el cliente tiene acceso de solo lectura.

MSGFLAG_ORIGIN_EXT_SEND

El mensaje se originó fuera de la organización. El cliente debe mostrar un mensaje adecuado al usuario. Los proveedores de transporte establecen esta marca; el cliente tiene acceso de solo lectura.

MSGFLAG_READ

El mensaje se marca como leído. Esto puede ocurrir como resultado de una llamada en cualquier momento a IMessage::SetReadFlag o IMAPIFolder::SetReadFlags. Los clientes también pueden establecer esta marca llamando al método IMAPIProp::SetProps de un mensaje antes de que el mensaje se haya guardado por primera vez. Esta marca se omite si se establece la marca de MSGFLAG_ASSOCIATED .

MSGFLAG_RESEND

El mensaje incluye una solicitud para una operación de reenviar con un informe no entrega. El cliente o proveedor tiene acceso de lectura y escritura a esta marca hasta la primera llamada a IMAPIProp::SaveChanges y de solo lectura a partir de entonces.

MSGFLAG_RN_PENDING

Se debe enviar un informe de lectura para el mensaje. El cliente o proveedor tiene acceso de solo lectura a esta marca.

MSGFLAG_SUBMIT

El mensaje está marcado para enviarse como resultado de una llamada a IMessage::SubmitMessage. Los proveedores del almacén de mensajes establecen esta marca; el cliente tiene acceso de solo lectura.

MSGFLAG_UNMODIFIED

El mensaje saliente no se ha modificado desde la primera vez que se guardó; el mensaje entrante no se ha modificado desde que se entregó.

MSGFLAG_UNSENT

El mensaje todavía se está redactando. Se guarda, pero no se ha enviado. El cliente o proveedor tiene acceso de lectura y escritura a esta marca hasta la primera llamada a IMAPIProp::SaveChanges y de solo lectura a partir de entonces. Si un cliente no establece esta marca en el momento en que se envía el mensaje, el proveedor del almacén de mensajes lo establece cuando se llama a IMessage::SubmitMessage . Normalmente, esta marca se borra después de enviar el mensaje.

Un proveedor de cliente o almacén de mensajes puede comprobar el estado actual del mensaje en cualquier momento llamando al método IMAPIProp::GetProps para leer los valores de marca. El cliente o proveedor también puede llamar al método IMAPIProp::SetProps para cambiar las marcas que actualmente tienen acceso de lectura y escritura.

Varias de las marcas siempre son de solo lectura. Algunos son de lectura y escritura hasta la primera llamada al método IMAPIProp::SaveChanges y, a partir de entonces, se convierten en de solo lectura hasta IMAPIProp::SetProps . Una de ellas, MSGFLAG_READ, se puede cambiar más adelante a través de IMessage::SetReadFlag o IMAPIFolder::SetReadFlags.

Los valores iniciales de esta propiedad suelen MSGFLAG_UNSENT y MSGFLAG_UNMODIFIED para indicar un mensaje que aún no se ha enviado ni cambiado. Cuando se guarda un mensaje por segunda vez, el proveedor del almacén de mensajes borra la marca de MSGFLAG_UNMODIFIED. Otro valor que puede establecer un proveedor de almacén de mensajes cuando se guarda un mensaje es la marca MSGFLAG_HASATTACH, que indica que el mensaje tiene uno o varios datos adjuntos. La propiedad PR_HASATTACH se calcula a partir de esta configuración.

Cuando un cliente llama al método IMessage::SubmitMessage para enviar el mensaje, el proveedor del almacén de mensajes realiza una copia del mismo para la cola MAPI y actualiza esta propiedad estableciendo la marca MSGFLAG_SUBMIT. El proveedor del almacén de mensajes también establece MSGFLAG_UNSENT si aún no está establecido. MSGFLAG_SUBMIT indica que se ha llamado a SubmitMessage , comenzando el proceso de envío y que el mensaje ahora es de solo lectura para el cliente. MSGFLAG_UNSENT indica que la cola MAPI controla el mensaje. Si se cancela el proceso de envío, el proveedor del almacén de mensajes restablece esta marca.

Cuando el mensaje se asigna a un proveedor de transporte para su entrega, el proveedor de transporte establece la marca de MSGFLAG_FROMME si el remitente tenía la misma cuenta en el servidor de mensajería en la que se recibió el mensaje. Los proveedores de transporte establecen MSGFLAG_FROMME para un mensaje entrante enviado por el usuario que ha iniciado sesión actualmente. Un cliente puede usar este valor para determinar que es más adecuado mostrar los nombres de destinatario en la tabla de contenido de la carpeta Elementos enviados que los nombres de remitente. Los mensajes que se han guardado durante el proceso de composición y que aún no se han enviado también deben mostrarse con nombres de destinatario en lugar de nombres de remitente.

Para un mensaje entrante, un proveedor de almacén de mensajes borra la marca de MSGFLAG_READ para restablecer su estado de lectura. Un cliente puede establecer o borrar la marca de MSGFLAG_READ cuando sea necesario cambiar el estado de lectura y controlar el envío de informes de lectura y no leídos, llamando al método IMessage::SetReadFlag del mensaje o al método IMAPIFolder::SetReadFlags de su carpeta. La principal diferencia entre estos métodos, aparte del objeto que los implementa, es que el método folder puede afectar a uno, varios o todos los mensajes de la carpeta. El método message afecta a un único mensaje.

Un cliente también debe probar un mensaje entrante para las marcas de MSGFLAG_ORIGIN_X400, MSGFLAG_ORIGIN_INTERNET, MSGFLAG_ORIGIN_MISC_EXT y MSGFLAG_ORIGIN_EXT_SEND. El proveedor de transporte de entrada establece estas marcas e indican que el mensaje llegó desde un origen que la puerta de enlace no puede considerar de confianza. Esto significa que el mensaje se originó fuera de la organización o internamente, pero desde una estación de trabajo que la puerta de enlace no conoce. En cualquier caso, es posible que no se confirme la identidad del remitente y existe el riesgo de introducir un virus informático en la organización. El cliente debe mostrar un mensaje de advertencia al usuario y ofrecer una opción para eliminar el mensaje sin abrirlo.

Los proveedores de almacén de mensajes establecen la marca de MSGFLAG_UNMODIFIED para los mensajes entrantes. MSGFLAG_UNMODIFIED indica que no se ha cambiado un mensaje desde la entrega. Un cliente no puede borrar este valor después de que lo haya establecido un proveedor de almacén de mensajes.