Finding a PIM Item Within a Collection

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Locating a particular PIM item within the Outlook Mobile database involves calling the IPOutlookItemCollection::Find method on the collection.

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

To find a task by subject

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 *pFoundTask;
   

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. Search the collection of Task items for an item that matches your search criteria:

   pItems->Find(_T("[Subject] = \"meeting\""), reinterpret_cast<IDispatch **>(&pFoundTask));
   

Example

The following code example demonstrates how to retrieve a Task item from the Tasks folder, based on the information in its Subject property.

BSTR restriction = "[Subject] = \"meeting\"";

void FindTask(IPOutlookApp *polApp, ITask *pFoundTask, BSTR restriction)
{
    IPOutlookItemCollection * pItems;
    IFolder                 * pFolder;

    polApp->GetDefaultFolder(olFolderTasks, &pFolder)
    pFolder->get_Items(&pItems);
    pItems->Find(_T(restriction), reinterpret_cast<IDispatch **>(&pFoundTask));
}

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

Reference

IPOutlookItemCollection::Find

Other Resources

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