# saiAsrGetNBestListLength

Retrieves the maximum number of alternative results the recognizer can return for matches above the confidence threshold.

#### Prototype

DWORD saiAsrGetNBestListLength ( SAI_RECOGNIZER_HANDLE recog H d, DWORD *value )

Argument | Description
recogHd | Handle associated with a recognizer resource.
value | Pointer to the number of results to return.

#### Return values

Return value | Description
SUCCESS |
SAIERR_INVALID_PARAMETER | One of the specified arguments is invalid.
SAIERR_UNSUPPORTED_SPEECH_PARAMETER | Recognizer engine does not support the specified parameter.

#### Details

When the recognizer matches an incoming stream with the specified grammar, it sometimes finds more than one match due to the word confidence levels or conversation paths. The best-list-length parameter sets the number of alternate results the recognizer returns in the SAIEVN_ASR_RECOGNITION_DONE event buffer.

#### See also

saiAsrGetConfidenceThreshold, saiAsrSetNBestListLength