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