OpenIMsgSession

Gilt für: Outlook 2013 | Outlook 2016

Erstellt und öffnet eine Nachrichtensitzung, die die darin erstellten Nachrichten gruppiert.

SCODE OpenIMsgSession(
  LPMALLOC lpMalloc,
  ULONG ulFlags,
  LPMSGSESS FAR * lppMsgSess
);

Parameter

lpMalloc

[in] Zeiger auf ein Speicherzuweisungsobjekt, das die OLE IMalloc-Schnittstelle verfügbar macht. MAPI muss diese Zuordnungsmethode verwenden, wenn Sie mit der OLE IStorage-Schnittstelle arbeiten.

ulFlags

[in] Reserviert. NULL muss sein.

lppMsgSess

[out] Zeiger auf einen Zeiger auf das zurückgegebene Nachrichtensitzungsobjekt.

Rückgabewert

S_OK

Die Sitzung wurde geöffnet.

MAPI_E_INVALID_PARAMETER

lpMalloc oder lppMsgSess ist NULL.

MAPI_E_INVALID_FLAGS

Ungültige Flags wurden übergeben.

MAPI_UNICODE

Beim Aufrufen dieser Funktion legt ein Client oder Dienstanbieter das flag MAPI_UNICODE fest, um Unicode-.msg-Dateien zu erstellen. Die resultierende Imessage-Datei zeigt STORE_UNICODE_OK im PR_STORE_SUPPORT_MASK an und unterstützt Unicode-Eigenschaften.

Hinweise

Eine Nachrichtensitzung wird von Clientanwendungen und Dienstanbietern verwendet, die mit mehreren verwandten MAPI-IMessage-Objekten umgehen möchten: IMAPIProp-Objekte , die auf zugrunde liegenden OLE IStorage-Objekten basieren. Der Client oder Anbieter verwendet die Funktionen OpenIMsgSession und CloseIMsgSession , um die Erstellung solcher Nachrichten innerhalb einer Nachrichtensitzung zu umschließen. Nachdem die Nachrichtensitzung geöffnet wurde, übergibt der Client oder Anbieter in einem Aufruf von OpenIMsgOnIStg einen Zeiger darauf, um ein neues IMessage-on-IStorage-Objekt zu erstellen.

Eine Nachrichtensitzung verfolgt alle IMessage-on-IStorage-Objekte, die während der Dauer der Sitzung erstellt wurden, zusätzlich zu allen Anlagen und anderen Eigenschaften der Nachrichten. Wenn ein Client oder Anbieter CloseIMsgSession aufruft, werden alle diese Objekte geschlossen. Das Aufrufen von CloseIMsgSession ist die einzige Möglichkeit, IMessage-on-IStorage-Objekte zu schließen.

OpenIMsgSession wird von Clients und Anbietern verwendet, die die Möglichkeit benötigen, mehrere verwandte Nachrichten als OLE IStorage-Objekte zu verarbeiten. Wenn nur eine solche Nachricht gleichzeitig geöffnet sein soll, ist es nicht erforderlich, mehrere Nachrichten nachzuverfolgen, und es gibt keinen Grund, eine Nachrichtensitzung mit OpenIMsgSession zu erstellen.

Da es sich um ein zugrunde liegendes OLE-Objekt handelt, muss MAPI die OLE-Speicherbelegung verwenden. Weitere Informationen zu strukturierten OLE-Speicherobjekten und zur OLE-Speicherbelegung finden Sie unter OLE und Datenübertragung.