Microsoft Speech SDK
SAPI 5.1
ISpRecognizer::GetRecoProfile
ISpRecognizer::GetRecoProfile retrieves the current recognition profile token.
HRESULT GetRecoProfile(
ISpObjectToken **ppToken
);
Parameters
- ppToken
- [out] Address of a pointer of an ISpObjectToken that receives the profile information.
Return values
| Value | Description |
|---|---|
| S_OK | Function completed successfully. |
| E_POINTER | The ppToken is a bad or invalid pointer. |
| FAILED(hr) | Appropriate error message. |
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 find which profile is currently being used.
If an application needs to store information in a specific recognition profile, it can use the ISpObjectToken::GetStorageFilename method.
Example
The following code snippet illustrates the use of ISpRecognizer::GetRecoProfile to determine the profile name
HRESULT hr = S_OK;
// get the current recognizer's recognition profile token
hr = cpRecognizer->GetRecoProfile(&cpObjectToken);
// Check hr
// get the reco profile name (i.e. the default value of the token)
hr = cpObjectToken->GetStringValue(NULL, &pwszRecoProfileName);
// Check hr