Important: |
---|
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
The IPOutlookAppinterface 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_Applicationglobally unique identifier (GUID), and receives a reference to an application object. The application object is the only POOM object retrieved with CoCreateInstance.
Methods in Vtable Order
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 IFolderobject 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 TRUEif the mobile device is partnered with a desktop computer running Outlook and returns FALSEif the desktop computer is running Schedule+. |
|
Uses a time zone index to return an ITimeZoneobject for the corresponding time zone. |
|
Uses a time zone index to get the TIME_ZONE_INFORMATIONstructure (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. |
Example
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. |
Copy Code | |
---|---|
#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(); |
Requirements
Header | pimstore.h |
Library | Pimstore.lib |
Windows Embedded CE | Windows CE 2.0 and later |
Windows Mobile | Windows Mobile Version 5.0 and later |