IPOutlookItemCollection::Add
A version of this page is also available for
4/8/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.
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 |
| Windows Embedded CE | Windows CE 2.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Tasks
Adding PIM Items to the Outlook Mobile Database
Reference
Pocket Outlook Object Model Interfaces