IItem::Edit

Article
08/28/2006

The Edit method opens the PIM item for editng in it's Edit tab.

Syntax

HRESULT Edit(
  HWND hwndParent
);

Parameters

hwndParent
[in] Handle to the parent window.

Return Values

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_ACCESSDENIED, E_UNEXPECTED, and E_FAIL, as well as the following:

S_OK
The method completed successfully.

Remarks

You can call IItem::Edit on unsaved as well as saved PIM items.

Code Example

The following code example demonstrates how to use Edit.

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.

HRESULT EditExample(IItem *pItem)
{

    HRESULT hr   = E_FAIL;
    HWND    hWnd = NULL;

    // You should set the hWnd to the window you want the summary card to be parented to.
    // If hWnd = NULL, then it uses the hwnd passed into IPOutlookApp::Logon.
    // The edit card that is displayed depends upon the item type.
    hr = pItem->Edit(hWnd);

    // This statement is reached when the edit card is dismissed.
    return hr;

}

Requirements

Pocket PC: Windows Mobile Version 5.0 and later
Smartphone: Windows Mobile Version 5.0 and later
OS Versions: Windows CE 5.01 and later
Header: pimstore.h
Library: pimstore.lib