IPOutlookItemCollection::Add (Compact 7)

Article
03/14/2014

3/12/2014

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

Syntax

HRESULT Add(
   IDispatch ** ppolItem
);

Parameters

ppolItem
[out] Handle to the new PIM item.

Return Value

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)
{
    IFolder                 * pFolder;
    IPOutlookItemCollection * pItems;
    ITask                   * pTask;

    polApp->GetDefaultFolder(olFolderTasks, &pFolder);

    pFolder->get_Items(&pItems);

    pItems->Add((IDispatch**)&pTask);

    // Commit the Task item to the Item Store.
    pTask->Save();

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

Requirements

Header	pimstore.h
Library	Pimstore.lib