Export (0) Print
Expand All

IPOutlookItemCollection::Remove

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

The Remove method removes an item from the item collection, based on the current sort order.


HRESULT Remove(
  int iItem
);

iItem

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

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.

You can remove only user-defined items. Items in ROM cannot be removed.

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

Aa912200.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 RemoveAnItem(IPOutlookApp * polApp)
{
    IPOutlookItemCollection * pItems;
    IFolder * pFolder;
    ITask   * pTask;
    // Remove the fifth item in the tasks Items collection.
    polApp->GetDefaultFolder(olFolderTasks, &pFolder);
    pFolder->get_Items(&pItems);
    pItems->Remove(5)
    // Release objects.
    pItems->Release();
    pFolder->Release();
    pTask->Release();
}

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