Share via


ISpSREngine2::SetRuleWeight (SAPI 5.4)

Microsoft Speech API 5.4

ISpSREngine2::SetRuleWeight

ISpSREngine2::SetRuleWeight sets the weight of a rule in a CFG.

  
    HRESULT SetRuleWeight(
   SPRULEHANDLE    hRule,
   void           *pvClientRuleContext,
   float           flWeight
);

Parameters

  • hRule
    The handle to the rule.
  • pvClientRuleContext
    Pointer to the engine's data associated with the rule.
  • flWeight
    The weight.

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".