SetMaxResultsHRC 

2.0     

Sets the maximum number of guesses a recognizer should make when interpreting pen data. When the recognizer formulates this number of results, the recognition process ends.

int SetMaxResultsHRC( HRC hrc, UINT cMaxResults )

Parameters

hrc

Handle to the HRC object for the recognizer.

cMaxResults

The maximum number of results a recognition context should generate. This value must be greater than 0.

Return Value

Returns HRCR_OK if successful; otherwise, returns one of the following negative values:

Constant

Description

HRCR_ERROR

Invalid parameter or other error.

HRCR_MEMERR

Insufficient memory.

HRCR_UNSUPPORTED

The recognizer does not support this function.

 

Comments

Subsequent calls to SetMaxResultsHRC override any previous settings. If the application does not call SetMaxResultsHRC to explicitly set a maximum value, the default number of results generated is 1.

See Also

GetMaxResultsHRC, CreateCompatibleHRC