Share via


ISpRecognizer::SetRecoProfile (SAPI 5.4)

Microsoft Speech API 5.4

ISpRecognizer::SetRecoProfile

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

  
    HRESULT SetRecoProfile(ISpObjectToken   *pToken
);

Parameters

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

Return values

Value
S_OK
E_INVALIDARG
FAILED(hr)

Remarks

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.