IPOutlookApp::CreateItem

Article
08/28/2006

The CreateItem method creates and gets a POOM item. The item is created in the default folder for the specified type.

Syntax

HRESULT CreateItem(
  int olItem,
  IDispatch ** ppolItem
);

Parameters

olItem
[in] PIM item type to create. One of the OlItemType enumeration values.
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.

Code Example

The following code example shows how to create a new POOM Contact item.

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 CreateAnItem(IPOutlookApp * polApp)
{
    IContact * pContact;
    polApp->CreateItem(olContactItem, (IDispatch**)&pContact);
    pContact->Release();
}

Remarks

This method creates an item without having to first retrieve the appropriate folder. The new item is created in memory. You must save the item to the designated collection.

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