Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This interface represents the POOM Application object. This object serves several purposes:
- As the root object, it provides access to all other objects in the Pocket Outlook hierarchy.
- It provides direct access to newly created items through CreateItem, without having to traverse the object hierarchy.
- It provides direct access to existing items through GetItemFromOid.
An application creates this interface by calling CoCreateInstance, using the CLSID_Application globally unique identifier (GUID), and receiving a pointer to an Application object. The Application object is the only POOM object retrieved with CoCreateInstance.
Methods in Vtable Order
| Method | Description |
|---|---|
| Logoff | Logs the user off of an Pocket Outlook session. |
| GetDefaultFolder | Gets one of the folder objects: calendar, tasks, contacts, or infrared. |
| CreateItem | Creates an appointment, task, or contact item. |
| ReceiveFromInfrared | Initiates reception of an item through an infrared link. |
| GetTimeZoneFromIndex | Gets time zone object. |
| GetTimeZoneInformationFromIndex | Fills a TIME_ZONE_INFORMATION structure (C or C++ only). |
| GetItemFromOid | Reads an item from its OID. |
| SysFreeString | Frees strings return from functions on a Palm-size PC. On other devices this method calls SysFreeString. |
Example
The following example shows how to create an Application object, log the user on, and display the Pocket Outlook version.
#define INITGUID
#include <windows.h>
#include <pimstore.h>
HRESULT hr;
IPOutlookApp *polApp;
// Initialize COM for Pocket Outlook
if (FAILED(CoInitializeEx(NULL, 0))) return FALSE;
// Get the application object.
hr = CoCreateInstance (CLSID_Application, NULL, CLSCTX_INPROC_SERVER,
IID_IPOutlookApp, (LPVOID*)&polApp);
if (FAILED(hr)) return FALSE;
// Log on to Pocket Outlook.
hr = polApp->Logon (NULL);
if (FAILED(hr)) return FALSE;
// Get the version and display it in a message box.
BSTR pwszVersion = NULL;
polApp->getVersion (&pwszVersion);
MessageBox (NULL, pwszVersion, TEXT ("POOM Version"), MB_SETFOREGROUND |
MB_OK);
// Free the version string
SysFreeString (pwszVersion);
// Note: For Palm-size PC version 1.0 use the Application method:
// polApp->SysFreeString (pwszVersion);
// Log off and release the Application object
polApp->Logoff ();
polApp->Release ();
return TRUE;
Requirements
OS Versions: Windows CE 2.0 and later.
Header: Pimstore.h.
Link Library: Pimstore.lib.
See Also
Send Feedback on this topic to the authors