IPOutlookApp::CreateItem
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
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