MapiMessage (Simple MAPI)

A MapiMessage structure contains information about a message.

Quick Info

Header file:

MAPI.H

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

Members

ulReserved

Reserved; must be zero.

lpszSubject

Pointer to the text string describing the message subject, typically limited to 256 characters or less. If this member is empty or NULL, the user has not entered subject text.

lpszNoteText

Pointer to a string containing the message text. If this member is empty or NULL, there is no message text.

lpszMessageType

Pointer to a string indicating a non-IPM type of message. Client applications can select message types for their non-IPM messages. Clients that only support IPM messages can ignore the lpszMessageType member when reading messages and set it to empty or NULL when sending messages.

lpszDateReceived

Pointer to a string indicating the date when the message was received. The format is YYYY/MM/DD HH:MM, using a 24-hour clock.

lpszConversationID

Pointer to a string identifying the conversation thread to which the message belongs. Some messaging systems can ignore and not return this member.

flFlags

Bitmask of message status flags. The following flags can be set:

MAPI_RECEIPT_REQUESTED: A receipt notification is requested. Client applications set this flag when sending a message.
MAPI_SENT: The message has been sent.
MAPI_UNREAD: The message has not been read.

lpOriginator

Pointer to a MapiRecipDesc structure containing information about the sender of the message.

nRecipCount

The number of message recipient structures in the array pointed to by the lpRecips member. A value of zero indicates no recipients are included.

lpRecips

Pointer to an array of MapiRecipDesc structures, each containing information about a message recipient.

nFileCount

The number of structures describing file attachments in the array pointed to by the lpFiles member. A value of zero indicates no file attachments are included.

lpFiles

Pointer to an array of MapiFileDesc structures, each containing information about a file attachment.