MapiMessageW structure

A MapiMessageW structure contains information about a message.

Syntax


typedef struct {
  ULONG            ulReserved;
  PWSTR            lpszSubject;
  PWSTR            lpszNoteText;
  PWSTR            lpszMessageType;
  PWSTR            lpszDateReceived;
  PWSTR            lpszConversationID;
  FLAGS            flFlags;
  lpMapiRecipDescW lpOriginator;
  ULONG            nRecipCount;
  lpMapiRecipDescW lpRecips;
  ULONG            nFileCount;
  lpMapiFileDescW  lpFiles;
} MapiMessageW, *lpMapiMessageW;

Members

ulReserved

Type: ULONG

Reserved; must be zero.

lpszSubject

Type: PWSTR

Pointer to the text string describing the message subject, typically limited to 256 characters or less.

If this member is empty or NULL, there is no subject text.

lpszNoteText

Type: PWSTR

Pointer to a string containing the message text.

If this member is empty or NULL, there is no message text.

lpszMessageType

Type: PWSTR

Pointer to a string that indicates the message type of when the message is not an IPM.

If your Client supports Interpersonal Messages (IPMs) exclusively, set the lpszMessageType member to empty or NULL when sending messages and ignore the member when reading messages.

lpszDateReceived

Type: PWSTR

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

lpszConversationID

Type: PWSTR

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

flFlags

Type: FLAGS

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

ValueMeaning
MAPI_RECEIPT_REQUESTED
0x00000002

A receipt notification is requested. Client applications set this flag when sending a message.

MAPI_SENT
0x00000004

The message has been sent.

MAPI_UNREAD
0x00000001

The message has not been read.

 

lpOriginator

Type: lpMapiRecipDescW

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

nRecipCount

Type: ULONG

The number of MapiRecipDescW structures in the array pointed to by the lpRecips member.

If this member is zero, there are no recipients.

lpRecips

Type: lpMapiRecipDescW

Pointer to an array of MapiRecipDescW structures. Each structure contains information about one recipient.

nFileCount

Type: ULONG

The number of MapiFileDescW structures in the array pointed to by the lpFiles member.

If this member is zero, there are no file attachments.

lpFiles

Type: lpMapiFileDescW

Pointer to an array of MapiFileDescW structures. Each structure contains information about one file attachment.

Requirements

Minimum supported client

Windows 8 [desktop apps only]

Minimum supported server

Windows Server 2012 [desktop apps only]

Header

Mapi.h

Unicode and ANSI names

MapiMessageW (Unicode) and MapiMessage (ANSI)

See also

MapiMessage
MAPISendMailW
MapiFileDescW
MapiRecipDescW

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.