Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

ISpRecognizer::SetRecoProfile (SAPI 5.4)

Speech API 5.4
Microsoft Speech API 5.4


ISpRecognizer::SetRecoProfile sets the recognition profile to be used by the recognizer.

HRESULT SetRecoProfile(
   ISpObjectToken   *pToken


[in] Address of an ISpObjectToken object that contains the profile information.

Return values

S_OKFunction completed successfully.
E_INVALIDARGOne or more parameters are invalid.
FAILED(hr)Appropriate error message.


A recognition profile represents a single user and training sessions on the system. The user can create, delete, and set the current profile using Speech properties in Control Panel. SAPI will always create the engine using the current default profile. This method can be used to set the SR engine to use a profile other than the default.

This method should not be called when the engine is currently processing audio. Calling ::SetRecoProfile with an active recognition engine can cause unexpected results, depending on how and when the SR engine reads the profile information.

© 2015 Microsoft