IInkDisp::Clone

4/8/2010

Creates a duplicate IInkDisp object.

Syntax

HRESULT Clone(
  [out, retval] IInkDisp **Ink
);

Parameters

  • Ink
    Returns the newly created IInkDisp object.

Return Value

  • S_OK
    Success.
  • E_OUTOFMEMORY
    Cannot allocate memory to complete the operation.
  • E_FAIL
    An unspecified error occurred.
  • E_POINTER
    A parameter contained an invalid pointer.
  • E_INK_EXCEPTION
    An exception occurred inside the method.
  • REGDB_CLASSNOTREG
    The IInkDisp object was not registered.
  • E_UNEXPECTED
    Unexpected parameter or property type.

Remarks

The Clone method returns an exact copy of the original object. There is no relationship between the original IInkDisp object and the clone.

If a dirty IInkDisp object is cloned, the duplicate IInkDisp object is not an exact copy of the original object. In this case, the duplicate IInkDisp object's IInkDisp::Dirty property is False. All other properties of the cloned IInkDisp object are exact copies.

Requirements

Header msinkaut.h
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile 6 Classic and later, Windows Mobile 6 Professional and later

See Also

Concepts

Windows Mobile Ink Reference