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