MapiMessageW-Struktur (mapi.h)

Eine MapiMessageW-Struktur enthält Informationen zu einer Nachricht.

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;

Member

ulReserved

Typ: ULONG

Reserviert; muss null sein.

lpszSubject

Typ: PWSTR

Zeiger auf die Textzeichenfolge, die den Betreff der Nachricht beschreibt, in der Regel auf 256 Zeichen oder weniger beschränkt.

Wenn dieser Member leer oder NULL ist, gibt es keinen Betrefftext.

lpszNoteText

Typ: PWSTR

Zeiger auf eine Zeichenfolge, die den Nachrichtentext enthält.

Wenn dieser Member leer oder NULL ist, gibt es keinen Nachrichtentext.

lpszMessageType

Typ: PWSTR

Zeiger auf eine Zeichenfolge, die den Nachrichtentyp von angibt, wenn die Nachricht kein IPM ist.

Wenn Ihr Client ausschließlich zwischenmenschliche Nachrichten (IPMs) unterstützt, legen Sie das element lpszMessageType beim Senden von Nachrichten auf leer oder NULL fest, und ignorieren Sie das Element beim Lesen von Nachrichten.

lpszDateReceived

Typ: PWSTR

Zeiger auf eine Zeichenfolge, die das Datum angibt, an dem die Nachricht empfangen wurde. Das Format ist JJJJ/MM/TTHH:MM, wobei eine 24-Stunden-Uhr verwendet wird.

lpszConversationID

Typ: PWSTR

Zeiger auf eine Zeichenfolge, die den Konversationsthread identifiziert, zu dem die Nachricht gehört. Einige Messagingsysteme ignorieren diesen Member.

flFlags

Typ: FLAGS

Bitmaske von Nachrichten status Flags. Die folgenden Flags können festgelegt werden.

Wert	Bedeutung
MAPI_RECEIPT_REQUESTED 0x00000002	Eine Empfangsbenachrichtigung wird angefordert. Clientanwendungen legen dieses Flag beim Senden einer Nachricht fest.
MAPI_SENT 0x00000004	Die Nachricht wurde gesendet.
MAPI_UNREAD 0x00000001	Die Nachricht wurde nicht gelesen.

lpOriginator

Typ: lpMapiRecipDescW

Zeiger auf eine MapiRecipDescW-Struktur , die Informationen über den Absender der Nachricht enthält.

nRecipCount

Typ: ULONG

Die Anzahl der MapiRecipDescW-Strukturen im Array, auf die das lpRecips-Element verweist.

Wenn dieses Element 0 ist, gibt es keine Empfänger.

lpRecips

Typ: lpMapiRecipDescW

Zeiger auf ein Array von MapiRecipDescW-Strukturen . Jede Struktur enthält Informationen zu einem Empfänger.

nFileCount

Typ: ULONG

Die Anzahl der MapiFileDescW-Strukturen im Array, auf die das lpFiles-Element verweist.

Wenn dieser Member 0 ist, gibt es keine Dateianlagen.

lpFiles

Typ: lpMapiFileDescW

Zeiger auf ein Array von MapiFileDescW-Strukturen . Jede Struktur enthält Informationen zu einer Dateianlage.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Kopfzeile	mapi.h

Weitere Informationen

MAPISendMailW

MapiFileDescW

MapiMessage

MapiRecipDescW