IPOutlookApp::CreateItem

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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. For information about IDispatch, see IDispatch.

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.

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

Header pimstore.h
Library Pimstore.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2000 and later, Smartphone 2002 and later

See Also

Tasks

Creating a PIM Item

Reference

IPOutlookApp
Pocket Outlook Object Model Interfaces

Other Resources

Pocket Outlook Object Model Enumerations