ISpSREngine2::SetRulePriority (SAPI 5.4)

  • Article

Microsoft Speech API 5.4

ISpSREngine2::SetRulePriority

ISpSREngine2::SetRulePriority sets the priority of a particular rule. Rules with higher priority have precedence.

  
    HRESULT SetRulePriority(
   SPRULEHANDLE    hRule,
   void           *pvClientRuleContext,
   int             nRulePriority
);

Parameters

  • hRule
    A handle to the rule.
  • pvClientRuleContext
    Pointer to the engine's data associated with the rule.
  • nRulePriority
    The priority.

Return values

Value
S_OK
E_NOINTERFACE

Remarks

Be sure that you use the correct letter casing when specifying the rule name. Rule names are case-sensitive in SAPI. For example, if the name of the rule to target is "Test", and you set the value of hRule to "test", the call will generate an error or incorrectly target a rule named "test".