IPOutlookApp
The IPOutlookApp interface represents the Outlook Mobile application object. This object serves the following purposes:
-
As the root object, it provides access to all of the other objects in the POOM hierarchy.
-
It provides direct access to newly created items, without having to traverse the object hierarchy.
-
It provides direct access to existing items.
An application creates this interface by calling CoCreateInstance, using the CLSID_Application globally unique identifier (GUID), and receives a reference to an application object. The application object is the only POOM object retrieved with CoCreateInstance.
| IPOutlookApp methods | Description |
|---|---|
|
Logs the user on to a POOM Session. | |
|
Logs the user off of a POOM Session. | |
|
Gets a three-part string describing the version of Outlook Mobile (or of Pocket Outlook) that is in use. | |
|
Gets an IFolder object for one of the five folders provided by Outlook Mobile. | |
|
Creates and gets a POOM item. | |
|
Retrieves the item specified by a Windows Embedded CE object identifier (OID). | |
|
Initiates reception of an item over an infrared link. | |
|
Returns TRUE if the mobile device is partnered with a desktop computer running Outlook and returns FALSE if the desktop computer is running Schedule+. | |
|
Uses a time zone index to return an ITimeZone object for the corresponding time zone. | |
|
Uses a time zone index to get the TIME_ZONE_INFORMATION structure (declared in winbase.h) for the corresponding time zone. | |
|
Gets the main Outlook Mobile application object. | |
|
Frees a string that was previously allocated. | |
|
Converts the Variant representation of time to it's system time equivalent. | |
|
Converts a system time object to it's Variant equivalent. |
The following example shows how to create an Outlook Mobile application object, log on, and display the Outlook Mobile version.
 Note: |
|---|
| 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. |
#define INITGUID
#include <windows.h>
#include <pimstore.h>
HRESULT hr;
IPOutlookApp * polApp;
// Initialize COM.
CoInitializeEx(NULL, 0);
// Get the Outlook Mobile application object.
hr = CoCreateInstance(CLSID_Application, NULL, CLSCTX_INPROC_SERVER, IID_IPOutlookApp, (LPVOID*)&polApp);
// Log on to POOM.
hr = polApp->Logon(NULL);
// Get the Outlook Mobile version, and display it in a message box.
BSTR pwszVersion = NULL;
polApp->getVersion(&pwszVersion);
MessageBox(NULL, pwszVersion, TEXT("Outlook Mobile Version"), MB_SETFOREGROUND | MB_OK);
// Free the version string.
SysFreeString(pwszVersion);
// Note: For Microsoft Palm-size PC 1.0, use the Application method:
// polApp->SysFreeString(pwszVersion).
// Log off and release the POOM application object.
polApp->Logoff();
polApp->Release();