mapiMessage 结构 (mapi.h)

项目
08/24/2023

MapiMessage 结构包含有关消息的信息。对于 Unicode 支持，请使用 MapiMessageW 结构。

语法

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;

成员

ulReserved

保留;必须为零或 CP_UTF8。如果 CP_UTF8，下面是 UTF-8 而不是 ANSI 字符串： lpszSubject、 lpszNoteText、 lpszMessageType、 lpszDateReceived、 lpszConversationID。

lpszSubject

指向描述邮件主题的文本字符串的指针，通常限制为 256 个字符或更少。如果此成员为空或 NULL，则表示用户尚未输入主题文本。

lpszNoteText

指向包含消息文本的字符串的指针。如果此成员为空或 NULL，则没有消息文本。

lpszMessageType

指向指示非 IPM 类型的消息的字符串的指针。客户端应用程序可以为其非 IPM 消息选择消息类型。仅支持 IPM 消息的客户端在读取消息时可以忽略 lpszMessageType 成员，并在发送消息时将其设置为空或 NULL 。

lpszDateReceived

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

lpszConversationID

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

flFlags

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

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