How to: End a MAPI Session

Article
08/28/2006

When the user is done performing messaging tasks, there is no further need to consume valuable system resources with the messaging subsystem. At this point, it is a good idea to free resources by ending the MAPI session.

To end the MAPI session

End the MAPI session with the IMAPISession::Logoff method, as follows:
```
hr = pSession->Logoff(0, 0, 0);
```
Decrement the MAPI session reference count by calling IUnknown::Release on the MAPI session object:
```
pSession->Release();
```
Decrement the MAPI subsystem reference count, and delete any per-instance global data for the MAPI DLL with the MAPIUninitialize global MAPI function:
```
MAPIUninitialize();
```

Example

The following code demonstrates how to end a MAPI session.

hr = pSession->Logoff(0, 0, 0);
if (hr != S_OK) {
    // Logoff failed.
    MessageBox(NULL, 
               _T("Logoff failed."),
               _T("Warning"), 
               MB_OK);
    exit(0);  // Replace with specific error handling.
}

pSession->Release();
pSession = NULL;
MAPIUninitialize();

Share via

How to: End a MAPI Session

Example

See Also

Additional resources