Integrating Applications with Outlook Mobile
A version of this page is also available for
4/8/2010
You can use the Pocket Outlook Object Model (POOM) to create mobile Personal Information Management (PIM) applications that integrate with Microsoft Outlook Mobile. You can add commands to the Tools menus of the Calendar, Tasks, and Contacts applications on a Windows Mobile device, and you can use POOM to manipulate their associated items, and the information that they contain. For detailed information about using the POOM APIs, refer to the Pocket Outlook Object Model Reference.
The main interface to the POOM is IPOutlookApp, the Outlook Mobile Application Object; from which all other POOM objects are derived. The Outlook Mobile application object is created by calling CoCreateInstance. By using IPOutlookApp::Logon to log on to the Outlook Mobile application object, you can retrieve handles to the various OlDefaultFolders objects by using IPOutlookApp::GetDefaultFolder.
The POOM Folder implementation is a subset of the Outlook Folder object. Each item type is associated with one of the OlDefaultFolders, and users cannot create or manipulate the Folder object itself. The Folder object is provided mainly for compatibility with Outlook.
The IPOutlookItemCollection object is obtained from the Folder object by using IFolder::get_Items. An Items collection is a collection of IContact, ITask, or IAppointment objects. You can retrieve individual items by using IPOutlookItemCollection::Item, delete individual items by using IPOutlookItemCollection::Remove, and create individual items by using IPOutlookItemCollection::Add. With the Items collection, you can also perform basic filtering over a collection of objects by using IPOutlookItemCollection::Restrict.
You can set and retrieve individual properties of an individual Outlook item by using the get/put property methods associated with each Outlook item type.
Task and Appointment items support the IRecurrencePattern object. With this object, you can set up a recurrence for a Task or Appointment. Appointment items also support the IRecipients collection, which lets you specify recipients for a meeting. An Appointment item that has a collection of recipients associated with it is a meeting request.
Note
For platform versions later than Windows Mobile 2003 Second Edition, you can no longer use the CePimCommand function for creating Outlook Mobile menu add-ins. Use the IContextMenu interface instead.