IItem::Copy (Compact 7)

Article
03/14/2014

3/12/2014

The Copy method creates a copy of a PIM item.

Syntax

HRESULT Copy(
   IItem ** ppolCopy
);

Parameters

ppolCopy
[out] Reference to the copied PIM IItem object.

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 demonstrates how to use Copy. In the example, pItemCopy contains a copy of the IItem object. All of the properties are copied, including named properties. Named properties created with the PIM_DONTREPLICATE set are not copied though. For more information, see GetIDsFromNames Flags.

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 CopyExample(IItem *pItem)
{
    HRESULT hr = E_FAIL;
    IItem *pItemCopy = NULL;

    hr = pItem->Copy(&pItemCopy);

    if(NULL != pItemCopy)
        pItemCopy->Release();

    return hr;
}

Remarks

If you modify an item's BodyInk binary stream data (that is, the PIMPR_BODY_BINARY property), you must save the item before copying it-otherwise that property will not be copied.

Streams behave differently depending on whether the item has been saved. You must call IStream::Commit(0) (note the parameter of zero) on the stream before calling IItem::Save on the item. If you do not, then the Item might not be saved. This depends on whether you have previously saved the item.

Both PIMPR_BODY_TEXT and PIMPR_BODY_BINARY are always copied.

Requirements

Header	pimstore.h
Library	Pimstore.lib

Partager via