Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

The IPOutlookItemCollectioninterface represents and manages a collection of PIM items contained in a Folder.

Methods in Vtable Order

IPOutlookItemCollection methods Description

IPOutlookItemCollection::Add

Creates a new item for a folder in the item collection.

IPOutlookItemCollection::get_Count

Gets the number of items in the collection.

IPOutlookItemCollection::Find

Finds the first PIM item in a collection that passes the specified restriction.

IPOutlookItemCollection::FindNext

Finds the next PIM item in a collection that passes the restriction specified by the most recent call to IPOutlookItemCollection::Find.

IPOutlookItemCollection::Item

Retrieves an item from the item collection, based on the current sort order.

IPOutlookItemCollection::Remove

Removes an item from the item collection, based on the current sort order.

IPOutlookItemCollection::Restrict

Creates a new item collection that contains only those items that meet a specified restriction.

IPOutlookItemCollection::Sort

Sorts items within an item collection, based upon an item property.

IPOutlookItemCollection::get_IncludeRecurrences

Determines whether to include recurrences in a collection of Appointment items sorted on the IAppointment::get_Startproperty, in ascending order.

IPOutlookItemCollection::put_IncludeRecurrences

Sets a flag to include recurrences in a collection of Appointment items sorted on the IAppointment::get_Startproperty in ascending order.

IPOutlookItemCollection::get__NewEnum

Gets the IEnumVARIANTenumerator interface.

IPOutlookItemCollection::get_Application

Gets the main Outlook Mobile IPOutlookAppobject.

Code Example

The following code example shows how to retrieve an Items collection.

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.
Copy Code
void GetAnItemsCollection(IPOutlookApp * polApp)
{
	IPOutlookItemCollection * pItems;
	IFolder				 * pFolder;

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

	// Release resources.
	pItems->Release();
	pFolder->Release();
}

Requirements

Header pimstore.h
Library Pimstore.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also