IPOutlookApp (Compact 7)

3/12/2014

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 Pocket Outlook Object Model (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.

Methods in Vtable Order

• IUnknown methods
• IDispatch methods

Example

The following example shows how to create an Outlook Mobile application object, log on, and display the Outlook Mobile version.

#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);

// Log off and release the POOM application object.
polApp->Logoff();
polApp->Release();

Requirements

See Also

Reference

Pocket Outlook Object Model Interfaces
Pocket Outlook Object Model Enumerations