Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

Gets the level of confidence (strong, intermediate, or poor) that a recognizer has in the recognition of an IInkRecognitionAlternateobject.

Syntax 

[propget] HRESULT get_Confidence ([out, retval]
InkRecognitionConfidence * Confidence
);

Parameters

Confidence

The level of confidence that a recognizer has in the recognition of an alternate.

This property is read–only.

Return Value

HRESULT value Description

S_OK

Success.

E_POINTER

The parameter is an invalid pointer.

E_INK_EXCEPTION

An exception occurred while processing.

E_NOTIMPL

Confidence evaluation is not available with the selected recognizer.

Remarks

For a list of confidence values that may be returned, see the InkRecognitionConfidenceenumeration type.

If the alternate represents a phrase or sentence, the value represents the lowest confidence level of a recognition segment found in the phrase or sentence. However, if the alternate represents a word, the value represents the confidence level of the word.

Note:
This property throws an exception if the IInkRecognizerthat generates the IInkRecognitionAlternatedoes not support confidence levels.

Of the Microsoft recognizers, only the Microsoft English (US) Handwriting Recognizer and the Microsoft Gesture Recognizer support confidence levels. Third party recognizers may or may not support confidence levels.

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