MapiMessage-Struktur (mapi.h)

Artikel
08/24/2023

Eine MapiMessage-Struktur enthält Informationen zu einer Nachricht. Verwenden Sie für Unicode-Unterstützung die MapiMessageW-Struktur .

Syntax

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;

Members

ulReserved

Reserviert; muss null oder CP_UTF8 sein. Wenn CP_UTF8, sind die folgenden UTF-8 anstelle von ANSI-Zeichenfolgen: lpszSubject, lpszNoteText, lpszMessageType, lpszDateReceived, lpszConversationID.

lpszSubject

Zeiger auf die Textzeichenfolge, die den Betreff der Nachricht beschreibt, in der Regel auf maximal 256 Zeichen beschränkt. Wenn dieser Member leer oder NULL ist, hat der Benutzer keinen Betrefftext eingegeben.

lpszNoteText

Zeiger auf eine Zeichenfolge, die den Nachrichtentext enthält. Wenn dieser Member leer oder NULL ist, ist kein Meldungstext vorhanden.

lpszMessageType

Zeiger auf eine Zeichenfolge, die einen Nicht-IPM-Nachrichtentyp angibt. Clientanwendungen können Nachrichtentypen für ihre Nicht-IPM-Nachrichten auswählen. Clients, die nur IPM-Nachrichten unterstützen, können das lpszMessageType-Element beim Lesen von Nachrichten ignorieren und beim Senden von Nachrichten auf leer oder NULL festlegen.

lpszDateReceived

Zeiger auf eine Zeichenfolge, die das Datum angibt, an dem die Nachricht empfangen wurde. Das Format ist YYYY/MM/TT HH:MM, wobei ein 24-Stunden-Format verwendet wird.

lpszConversationID

Zeiger auf eine Zeichenfolge, die den Unterhaltungsthread angibt, zu dem die Nachricht gehört. Einige Messagingsysteme können diesen Member ignorieren und nicht zurückgeben.

flFlags

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

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

lpOriginator

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

nRecipCount

Die Anzahl der Nachrichtenempfängerstrukturen im Array, auf das der lpRecips-Member verweist. Der Wert 0 (null) gibt an, dass keine Empfänger eingeschlossen werden.

lpRecips

Zeiger auf ein Array von MapiRecipDesc-Strukturen , die jeweils Informationen zu einem Nachrichtenempfänger enthalten.

nFileCount

Die Anzahl der Strukturen, die Dateianlagen in dem Array beschreiben, auf das der lpFiles-Member verweist. Der Wert 0 (null) gibt an, dass keine Dateianlagen enthalten sind.

lpFiles

Zeiger auf ein Array von MapiFileDesc-Strukturen , die jeweils Informationen zu einer Dateianlage enthalten.