The Logon method begins a session with the Outlook Mobile COM server, returning a handle that can be used in subsequent calls to each PIM Item's Display method. You must begin an Outlook Mobile session before you can call any of the other POOM APIs.
The following code example shows how to log the user on to a POOM session.
|To make the following code example easier to read, security checking and error handling are not included. This code example should not be used in a release configuration unless it has been modified to include them.|
HRESULT hr; IPOutlookApp * polApp; // Initialize COM for Outlook Mobile. if (FAILED(CoInitializeEx(NULL, 0))) return FALSE; // Get a handle to the Outlook Mobile application object. hr = CoCreateInstance(CLSID_Application, NULL, CLSCTX_INPROC_SERVER, IID_IPOutlookApp, (LPVOID*)&polApp); // Begin an Outlook Mobile session. hr = polApp->Logon(NULL);
LogOn must be called from a thread that will process Windows messages.
The Outlook Mobile application object is not built for thread safety. Do not access this object across multiple threads.
The parent window for the POOM session is the window that receives Outlook Mobile notification messages. For more information, see Notification Window Messages.