Export (0) Print
Expand All

IPOutlookItemCollection::Item

Windows Mobile 6.5
A version of this page is also available for
4/8/2010

The Item method retrieves an item from a folder, based on the current sort order.


HRESULT Item(
   int iItem,
   IDispatch ** ppolItem
);

iItem

[in] The one-based index for the item to retrieve. The index is the position of the item in the current sort order.

ppolItem

[out] Reference to the retrieved item. For information about IDispatch, see IDispatch.

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following:

S_OK

The method completed successfully.

The GetItemIndexFromOid function returns a zerobased index value in its dwIndex parameter. Since the IPOutlookItemCollection::Item iItem argument takes a onebased index value, you will receive a "one-off" error when you pass this value to IPOutlookItemCollection::Item—unless you add 1 to it first.

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

Aa913656.note(en-us,MSDN.10).gifNote:
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.
void GetAnItem(IPOutlookApp * polApp)
{
    IFolder                 * pFolder;
    IPOutlookItemCollection * pItems;
    ITask                   * pTask;

    // Get the fifth item in the Tasks folder.
    polApp->GetDefaultFolder(olFolderTasks, &pFolder);

    pFolder->get_Items(&pItems);

    pItems->Item(5,(IDispatch **)&pTask);

    // Do something with the Task ...

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

If the value for iItem is less then zero, or greater than the number of item in this folder, then Item returns E_INVALIDARG.

Headerpimstore.h
LibraryPimstore.lib
Windows Embedded CEWindows CE 2.0 and later
Windows MobileWindows Mobile Version 5.0 and later

Community Additions

ADD
Show:
© 2014 Microsoft