Platform SDK: MAPI |
The IXPLogon::TransportLogoff method initiates the logoff process.
See IXPLogon : IUnknown.
HRESULT TransportLogoff( ULONG ulFlags );
If anything other than S_OK is returned, the provider is logged off.
The MAPI spooler calls the IXPLogon::TransportLogoff method to terminate a transport provider session for a particular user. Before calling TransportLogoff, the MAPI spooler discards any data about supported messaging address types for this session passed in the IXPLogon::AddressTypes method.
The transport provider should be prepared to accept a call to TransportLogoff at any time. If a message is in process, the provider should stop the sending process.
The transport provider should release all resources allocated for its current session. If it has allocated any memory for this session with the MAPIAllocateBuffer function, it should free the memory by using the MAPIFreeBuffer function. Any memory allocated by the transport provider to satisfy calls to the IXPLogon::AddressTypes, IXPLogon::RegisterOptions, and IMAPISession::MessageOptions methods can be safely released at this time.
Usually, a provider should, on completing a TransportLogoff call, first invalidate its logon object by calling the IMAPISupport::MakeInvalid method and then release its support object. The provider's implementation of TransportLogoff should release the support object last because when the support object is released, the MAPI spooler can also release the provider object itself.
IMAPISession::MessageOptions, IMAPISupport::MakeInvalid, IMAPISupport::SpoolerYield, IXPLogon::AddressTypes, IXPLogon::RegisterOptions, MAPIAllocateBuffer, MAPIFreeBuffer