IInkRecognizerContext::Recognize

4/8/2010

The IInkRecognizerContext performs recognition on an IInkStrokes collection and returns recognition results.

Syntax

HRESULT Recognize(
  [in, out] InkRecognitionStatus *recognitionStatus,
  [out, retval] IInkRecognitionResult **RecognitionResult
);

Parameters

  • RecognitionResult
    Returns the IInkRecognitionResult results of a recognized collection of strokes or returns NULL if the recognizer could not compute a result for the ink.

Return Value

HRESULT value Description

S_OK

Success.

E_POINTER

A parameter contained an invalid pointer.

E_UNEXPECTED

Unexpected parameter or property type.

E_INK_EXCEPTION

An exception occurred inside the method.

E_OUTOFMEMORY

Cannot allocate memory operation.

Remarks

This method performs recognition synchronously.

You must use a try/catch block when calling Recognize because an exception is thrown when the IInkDisp object contains no strokes or only deleted strokes.

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