Retrieving a PIM Item from the Outlook Mobile Database

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Retrieving a PIM item from the Outlook Mobile database involves calling the IPOutlookItemCollection::Item method on the collection.

The Outlook Mobile database consists of three separate PIM item lists contained in the three Default Folders: the Appointments folder, the Tasks folder, and the Contacts folder.

To retrieve a particular item from the Tasks folder

1. Create an instance of the Outlook Mobile application object and then use it to establish a POOM session. For more information, see Establishing a POOM Session.

2. Declare a reference to a generic PIM item collection:

   IPOutlookItemCollection *pItems;
   

3. Declare a reference to a generic PIM item folder:

   IFolder *pFolder;
   

4. Declare a reference to a Task item:

   ITask *pTask;
   

5. Use the generic PIM item folder to get the Tasks folder:

   polApp->GetDefaultFolder(olFolderTasks, &pFolder);
   

6. Use the Tasks folder to get the collection of Task items:

   pFolder->get_Items(&pItems)
   

7. Get the third Task item from the collection of Task items:

   pItems->Item(3, &pTask)
   

Example

The following code example demonstrates how to retrieve the third Task item from the Tasks Folder.

int index = 3;

void RetrieveTask(IPOutlookApp *polApp, int index)
{
    IPOutlookItemCollection * pItems;
    IFolder                 * pFolder;
    ITask                   * pTask;

    polApp->GetDefaultFolder(olFolderTasks, &pFolder)
    pFolder->get_Items(&pItems);
    pItems->Item(index, &pTask)

    // ...
    // Do something with the Task item...
    // ...
}

To make the 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.

Compiling the Code

• Include Header File: PimStore.h
• Linker Dependency: PimStore.lib

See Also

Other Resources

Pocket Outlook Object Model Common Tasks
Pocket Outlook Object Model Application Development