The CloseIMsgSession function closes a message session and all the messages created within that session.
Note This function may not be supported in future versions of MAPI.
Header file: | IMESSAGE.H |
Implemented by: | MAPI |
Called by: | Client applications and service providers |
VOID CloseIMsgSession(
LPMSGSESS lpMsgSess
);
A message session is used by client applications and service providers that want to deal with several related MAPI IMessage objects built on top of underlying OLE IStorage objects. The client or provider uses the OpenIMsgSession and CloseIMsgSession functions to wrap the creation of such messages inside a message session. Once the message session is opened, the client or provider passes a pointer to it in a call to OpenIMsgOnIStg to create a new IMessage-on-IStorage object.
A message session keeps track of all IMessage-on-IStorage objects opened during the duration of the session, in addition to all the attachments and other properties of the messages. When a client or provider calls CloseIMsgSession, it closes all these objects. Calling CloseIMsgSession is the only way to close IMessage-on-IStorage objects.
IMessage-On-IStorage Functions