Freigeben über


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.