ISpRecognizer::SetRecoProfile (SAPI 5.3)

Speech API 5.3
Microsoft Speech API 5.3


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.