InkRecognizerContext::Clone

4/8/2010

Creates a duplicate IInkRecognizerContext object.

Syntax

HRESULT Clone(
  [out, retval] IInkRecognizerContext **RecognizerContext
);

Parameters

  • RecognizerContext
    Returns the newly created IInkRecognizerContext 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 IInkRecognizerContext object was not registered.
  • E_UNEXPECTED
    Unexpected parameter or property type.

Remarks

This method returns a copy of the original IInkRecognizerContext that contains the same settings as the original, but does not include the recognition results, if any. The settings that are copied include the recognition guide, character Autocomplete mode, a reference to the original IInkDisp object, and all properties that improve the recognition results.

No relation between the original object and the clone exists.

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