IPOutlookItemCollection::Add (Windows Embedded CE 6.0)

1/6/2010

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. For information about the VARIANT_BOOL type, see the union member of the PROPVARIANT structure.

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.

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

See Also

Tasks

Adding PIM Items to the Outlook Mobile Database

Reference

IPOutlookItemCollection
Pocket Outlook Object Model Interfaces

Other Resources