Finding a PIM Item Within a Collection

Article
08/28/2006

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 default folders: the Appointments folder, the Tasks folder, and the Contacts folder.

To find a task by subject

Create an instance of the Outlook Mobile application object and then use it to establish a POOM session. For more information, see How to: Establish a POOM session.
Declare a reference to a generic PIM item collection, as follows:
```
IPOutlookItemCollection *pItems;
```
Declare a reference to a generic PIM item folder:
```
IFolder *pFolder;
```
Declare a reference to a Task item:
```
ITask *pFoundTask;
```
Use the generic PIM item folder to get the Tasks folder:
```
polApp->GetDefaultFolder(olFolderTasks, &pFolder);
```
Use the Tasks folder to get the collection of Task items:
```
pFolder->get_Items(&pItems)
```

Search the collection of Task items for an item that matches your search criteria:

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

Code Example

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

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

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

    // Free memory.
    pItems->Release();
    pFolder->Release();
    pTask->Release();
}

Share via

Finding a PIM Item Within a Collection

Code Example

See Also

Additional resources