IPOutlookItemCollection::Remove

發行項
08/28/2006

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

Syntax

HRESULT Remove(
  int iItem
);

Parameters

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

Return Values

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.

Remarks

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

Code Example

The following code example shows how to remove an item from 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.

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

Requirements

Pocket PC: Pocket PC 2000 and later
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: pimstore.h
Library: pimstore.lib

共用方式為