ISpGrammarBuilder::ResetGrammar

Microsoft Speech SDK

The Microsoft.com Speech website Microsoft Speech SDK SAPI 5.1

ISpGrammarBuilder::ResetGrammar

ISpGrammarBuilder::ResetGrammar clears all grammar rules (un-defines them) and resets the grammar's language to NewLanguage. The state handles for this grammar are no longer valid after this point.

HRESULT ResetGrammar(
   LANGID   NewLanguage
);

Parameters

NewLanguage
[in] Language identifier associated with the grammar rule.

Return values

Value Description
S_OK Function completed successfully.
FAILED(hr) Appropriate error message.

Example

The following code snippet illustrates the use of ResetGrammar.

    HRESULT hr = S_OK;

    // ResetGrammar when no rules
    hr = pGrammarBuilder->ResetGrammar(409);
    // Check hr

    // Set language to default user language
    hr = pGrammarBuilder->ResetGrammar(SpGetUserDefaultUILanguage());
    // Check hr

    // Set language to non-english
    hr = pGrammarBuilder->ResetGrammar(MAKELANGID(LANG_CHINESE, SUBLANG_CHINESE_SIMPLIFIED));
    // Check hr
	
    hr = pGrammarBuilder->ResetGrammar(MAKELANGID(LANG_JAPANESE, SUBLANG_DEFAULT));
    // Check hr