ISpRecoGrammar::LoadCmdFromObject

Microsoft Speech SDK

The Microsoft.com Speech website Microsoft Speech SDK SAPI 5.1

ISpRecoGrammar::LoadCmdFromObject

ISpRecoGrammar::LoadCmdFromObject loads a CFG from a COM object. The COM object must be located inside of a Windows DLL.

HRESULT LoadCmdFromObject(
   REFCLSID        rcid,
   const WCHAR    *pszGrammarName,
   SPLOADOPTIONS   Options
);

Parameters

rcid
[in] The reference class ID of the object containing the command.
pszGrammarName
[in, string] The grammar name of the object containing the command.
Options
[in] Flag of type SPLOADOPTIONS indicating whether the file should be loaded statically or dynamically.

Return values

Value Description
S_OK Function completed successfully.
E_INVALIDARG pszGrammarName is invalid or bad. Alternatively, Options is neither SPLO_STATIC nor SPLO_DYNAMIC.
FAILED(hr) Appropriate error message.

Remarks

When an application calls ::LoadCmdFromObject, the currently loaded CFG or proprietary grammar will be unloaded.

See also ISpCFGInterpreter::InitGrammar.