HRESULT Find(PSRMODEINFO psrInfo, PSRMODEINFORANK psrInfoRank,
PSRMODEINFO psrInfoFound);
Finds the speech-recognition mode that most closely matches the desired characteristics.
· Returns NOERROR if successful, or one of these error values:
E_FAIL
E_INVALIDARG
E_OUTOFMEMORY
SRERR_INVALIDMODE
psrInfo
[in] Address of an SRMODEINFO structure that contains the desired characteristics.
psrInfoRank
[in] Address of an SRMODEINFORANK structure that contains the relative importance of each characteristic. If this parameter is NULL, the object uses the default ranking provided by the engine.
psrInfoFound
[out] Address of an SRMODEINFO structure that receives information about the speech-recognition mode that was found. It is valid only if the Find member function does not return an error value.
If no engines can be found or the system runs out of memory, Find returns an error value.