Microsoft Speech Platform
ISpRecoGrammar2::SetRulePriority
ISpRecoGrammar2::SetRulePriority sets the priority on the specified rule.
HRESULT SetRulePriority(
LPCWSTR pszRuleName,
ULONG ulRuleId,
int nRulePriority
);
Parameters
- pszRuleName
- The name of the rule.
- ulRuleId
- The ID number of the rule.
- nRulePriority
- The priority to be assigned to the rule (between -128 and + 127). When a given utterance satisfies more than one rule, the recognizer applies the rule with the highest priority. When an utterance satisfies several rules with the same priority, or several rules with no priority, the recognizer applies the most recently activated rule.
Return values
| Value | Description |
|---|---|
| S_OK | Function completed successfully. |
| E_INVALIDARG | One of the parameters is invalid. |
| FAILED(hr) | Appropriate error message. |