OpenIMsgSession
Gilt für: Outlook 2013 | Outlook 2016
Erstellt und öffnet eine Nachrichtensitzung, die die darin erstellten Nachrichten gruppiert.
| Eigenschaft | Wert |
|---|---|
| Headerdatei |
Imessage.h |
| Implementiert von: |
MAPI |
| Aufgerufen von: |
Clientanwendungen und Dienstanbieter |
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.