Send Feedback

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


HRESULT CreateItem(
  int olItem,
  IDispatch ** ppolItem


  • 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);


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.


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

See Also

How to: Create a PIM Item | IPOutlookApp | Pocket Outlook Object Model API Interfaces | Pocket Outlook Object Model API Enumerations

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.