Microsoft Speech SDK SAPI 5.1

---

ISpSREngineSite::GetContextMaxAlternates

ISpSREngineSite::GetContextMaxAlternates passes back the maximum number of alternates that should be generated for the specified recognition context.

HRESULT GetContextMaxAlternates(
   SPRECOCONTEXTHANDLE   hContext,
   ULONG                *pulNumAlts
);

Parameters

hContext

[in] Handle to the context.

pulNumAlts

[out] The maximum number of alternates to generate.

Return values

Value	Description
S_OK	Function completed successfully.
E_POINTER	pulNumAlts is invalid or bad.
FAILED (hr)	Appropriate error message.

Remarks

For SAPI command and control grammars, it is usually easier to use the ISpSREngineSite::GetMaxAlternates method.

This method currently applies to command and control and proprietary grammars, but not to dictation grammars.