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

字串的指標，指出收到訊息的日期。 格式為 YYYY/MM/DDHH：MM，使用 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