Estructura MapiMessage (mapi.h)

Artículo
03/09/2023

Una estructura MapiMessage contiene información sobre un mensaje. Para la compatibilidad con Unicode, use la estructura MapiMessageW .

Sintaxis

typedef struct {
  ULONG           ulReserved;
  LPSTR           lpszSubject;
  LPSTR           lpszNoteText;
  LPSTR           lpszMessageType;
  LPSTR           lpszDateReceived;
  LPSTR           lpszConversationID;
  FLAGS           flFlags;
  lpMapiRecipDesc lpOriginator;
  ULONG           nRecipCount;
  lpMapiRecipDesc lpRecips;
  ULONG           nFileCount;
  lpMapiFileDesc  lpFiles;
} MapiMessage, *lpMapiMessage;

Members

ulReserved

Reservados; debe ser cero o CP_UTF8. Si CP_UTF8, los siguientes son UTF-8 en lugar de cadenas ANSI: lpszSubject, lpszNoteText, lpszMessageType, lpszDateReceived, lpszConversationID.

lpszSubject

Puntero a la cadena de texto que describe el asunto del mensaje, normalmente limitado a 256 caracteres o menos. Si este miembro está vacío o NULL, el usuario no ha escrito el texto del asunto.

lpszNoteText

Puntero a una cadena que contiene el texto del mensaje. Si este miembro está vacío o NULL, no hay texto de mensaje.

lpszMessageType

Puntero a una cadena que indica un tipo de mensaje que no es IPM. Las aplicaciones cliente pueden seleccionar tipos de mensaje para sus mensajes que no son IPM. Los clientes que solo admiten mensajes IPM pueden omitir el miembro lpszMessageType al leer mensajes y establecerlo en vacío o NULL al enviar mensajes.

lpszDateReceived

Puntero a una cadena que indica la fecha en que se recibió el mensaje. El formato es AAAA/MM/DD HH:MM, usando un reloj de 24 horas.

lpszConversationID

Puntero a una cadena que identifica el subproceso de conversación al que pertenece el mensaje. Algunos sistemas de mensajería pueden omitir y no devolver este miembro.

flFlags

Máscara de bits de las marcas de estado del mensaje. Se pueden establecer las marcas siguientes.

Valor	Significado
MAPI_RECEIPT_REQUESTED	Se solicita una notificación de recibo. Las aplicaciones cliente establecen esta marca al enviar un mensaje.
MAPI_SENT	Se ha enviado el mensaje.
MAPI_UNREAD	El mensaje no se ha leído.

lpOriginator

Puntero a una estructura MapiRecipDesc que contiene información sobre el remitente del mensaje.

nRecipCount

Número de estructuras de destinatarios de mensajes de la matriz a las que apunta el miembro lpRecips . Un valor de cero indica que no se incluye ningún destinatario.

lpRecips

Puntero a una matriz de estructuras MapiRecipDesc , cada una de las cuales contiene información sobre un destinatario del mensaje.

nFileCount

Número de estructuras que describen los datos adjuntos de archivo en la matriz a las que apunta el miembro lpFiles . Un valor de cero indica que no se incluyen datos adjuntos de archivo.

lpFiles

Puntero a una matriz de estructuras MapiFileDesc , cada una de las cuales contiene información sobre un archivo adjunto.