ISpSREngineSite::GetRuleInfo (Windows CE 5.0)

Send Feedback

This method gets information about a CFG rule. The method can be called after the engine has been informed of a rule with a call to the ISpSREngine::RuleNotify method.

HRESULT GetRuleInfo(  SPRULEENTRY* pRuleEntry,  SPRULEINFOOPT Options);

Parameters

  • pRuleEntry
    [in, out] Pointer to an SPRULEENTRY structure that contains the grammar rule entry information. The engine only needs to fill in the hRule member of the structure when calling this method. If the engine wants to use the pvClientRuleContext member in the structure, it can set it by calling ISpSREngineSite::SetRuleClientContext. The engine can also set the hInitialState member of the structure. Information on the initial and subsequent states can be obtained by calling the ISpSREngineSite::GetStateInfo method.
  • Options
    [in] A grammar rule option. Possible values are defined for the SPRULEINFOOPT enumeration. For this parameter, the option must always be SPRIO_NONE.

Return Values

The following table shows the possible return values.

Value Description
S_OK Function completed successfully.
E_POINTER pRuleEntry points to invalid memory.
E_INVALIDARG Either invalid hRule rule handle specified for pRuleEntry or Options contains invalid flags.
FAILED(hr) Appropriate error message.

Requirements

OS Versions: Windows CE .NET 4.1 and later.
Header: Sapiddk.h, Sapiddk.idl.
Link Library: Sapilib.lib.

See Also

ISpSREngineSite | SAPI Interfaces

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.