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.

See Also

MapiFileDesc, MapiRecipDesc