mapiMessageW 结构 (mapi.h)

MapiMessageW 结构包含有关消息的信息。

语法

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;

成员

ulReserved

类型: ULONG

保留;必须为零。

lpszSubject

类型: PWSTR

指向描述邮件主题的文本字符串的指针,通常限制为 256 个字符或更少。

如果此成员为空或 NULL,则没有主题文本。

lpszNoteText

类型: PWSTR

指向包含消息文本的字符串的指针。

如果此成员为空或 NULL,则没有消息文本。

lpszMessageType

类型: PWSTR

指向字符串的指针,该字符串指示消息类型(当消息不是 IPM 时)。

如果客户端仅支持人际消息 (IPM) ,请在发送消息时将 lpszMessageType 成员设置为空或 NULL ,并在读取消息时忽略该成员。

lpszDateReceived

类型: PWSTR

指向指示消息接收日期的字符串的指针。 格式为 YYYYY/MM/DDHHMM,使用 24 小时制。

lpszConversationID

类型: PWSTR

指向标识消息所属会话线程的字符串的指针。 某些消息传送系统会忽略此成员。

flFlags

类型: FLAGS

消息状态标志的位掩码。 可以设置以下标志。

含义
MAPI_RECEIPT_REQUESTED
0x00000002
请求回执通知。 客户端应用程序在发送消息时设置此标志。
MAPI_SENT
0x00000004
消息已发送。
MAPI_UNREAD
0x00000001
尚未读取消息。

lpOriginator

类型: lpMapiRecipDescW

指向 MapiRecipDescW 结构的指针,该结构包含有关邮件发件人的信息。

nRecipCount

类型: ULONG

lpRecips 成员指向的数组中 MapiRecipDescW 结构的数目。

如果此成员为零,则没有收件人。

lpRecips

类型: lpMapiRecipDescW

指向 MapiRecipDescW 结构数组的指针。 每个结构都包含有关一个收件人的信息。

nFileCount

类型: ULONG

lpFiles 成员指向的数组中的 MapiFileDescW 结构数。

如果此成员为零,则没有文件附件。

lpFiles

类型: lpMapiFileDescW

指向 MapiFileDescW 结构数组的指针。 每个结构都包含有关一个文件附件的信息。

要求

要求
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
标头 mapi.h

另请参阅

MAPISendMailW

MapiFileDescW

MapiMessage

MapiRecipDescW