ISpSREngine::WordNotify (Windows CE 5.0)
This method notifies the SR engine when words in command and control grammars are being added or removed. This method is called by SAPI when an application loads, unloads, or modifies grammars. SAPI internally keeps a reference count so that each word will only be added if it is not already present in any existing grammar.
HRESULT WordNotify( SPCFGNOTIFY Action, ULONG cWords, const SPWORDENTRY* pWords);
Parameters
- Action
[in] Action that is occurring. Possible values are defined for the SPCFGNOTIFY enumeration. Currently the value must be either SPCFGN_ADD when words are added, or SPCFGN_REMOVE when they are deleted. - cWords
[in] Number of words specified by pWords. - pWords
[in] Pointer to an array of SPWORDENTRY structures containing information about the words.
Return Values
The following table shows the possible return values.
| Value | Description |
|---|---|
| S_OK | Function completed successfully. |
| SPERR_NO_WORD_PRONUNCIATION | The engine could not generate a pronunciation for some of the words added. |
| FAILED(hr) | Other appropriate error message. |
Requirements
OS Versions: Windows CE .NET 4.1 and later.
Header: Sapiddk.h, Sapiddk.idl.
Link Library: Sapilib.lib.
See Also
Send Feedback on this topic to the authors