IPOutlookItemCollection::Add

Article
08/28/2006

The Add method creates a new item for a folder in the Items collection. The item type depends on the folder type.

Syntax

HRESULT Add(
  IDispatch ** ppolItem
);

Parameters

ppolItem
[out] Reference to the new item.

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

This method creates an item in memory. You must still save the item to the collection.

Code Example

The following code example shows how to add an item to 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 CreateTask(IPOutlookApp * polApp)
{
    IPOutlookItemCollection * pItems;
    ITask * pTask;
    pFolder->get_Items(&pItems);
    pItems->Add((IDispatch**)&pTask)

    // Commit the item to the store.
    pTask->Save();

    // Release objects.
    pItems->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

Share via