ISpRecognizer::SetRecoProfile
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
This method sets the recognition profile for the recognizer to use. A recognition profile represents a single user and training sessions on the system. The user can create, delete and set the current profile by using the Speech Control Panel.
SAPI always creates the SR engine using the current default profile. This method can be used to set the SR engine to use a different profile from the default.
This method should not be called when the SR engine is currently processing audio. Calling it with an active recognition engine can cause unexpected results, depending on how and when the SR engine reads the profile information.
Syntax
HRESULT SetRecoProfile(
ISpObjectToken* pToken
);
Parameters
- pToken
[in] Pointer to an object implementing ISpObjectToken for the profile information.
Return Value
The following table shows the possible return values.
| Value | Description |
|---|---|
S_OK |
Function completed successfully. |
E_INVALIDARG |
One or more arguments are invalid. |
FAILED(hr) |
Appropriate error message. |
Requirements
| Header | sapi.h, sapi.idl |
| Library | sapilib.lib |
| Windows Embedded CE | Windows CE .NET 4.1 and later |