CloseIMsgSession
Gilt für: Outlook 2013 | Outlook 2016
Schließt eine Nachrichtensitzung und alle in dieser Sitzung erstellten Nachrichten.
Eigenschaft | Wert |
---|---|
Headerdatei |
Imessage.h |
Implementiert von: |
MAPI |
Aufgerufen von: |
Clientanwendungen und Dienstanbieter |
VOID CloseIMsgSession(
LPMSGSESS lpMsgSess
);
Parameter
lpMsgSess
[in] Zeiger auf das Nachrichtensitzungsobjekt, das mit der OpenIMsgSession-Funktion zu Beginn der Nachrichtensitzung abgerufen wurde.
Rückgabewert
None.
Hinweise
Eine Nachrichtensitzung wird von Clientanwendungen und Dienstanbietern verwendet, die mehrere verwandte MAPI-IMessage-Objekte verarbeiten möchten, 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 geöffnet 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.