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

字串的指標，指出收到訊息的日期。格式為 YYYY/MM/DD HH：MM，使用 24 小時制。

lpszConversationID

字串的指標，識別訊息所屬的交談執行緒。某些傳訊系統可以忽略，而不會傳回此成員。

flFlags

訊息狀態旗標的位元遮罩。您可以設定下列旗標。

值	意義
MAPI_RECEIPT_REQUESTED	系統會要求收據通知。用戶端應用程式會在傳送訊息時設定此旗標。
MAPI_SENT	已傳送訊息。
MAPI_UNREAD	尚未讀取訊息。