TtsLoadUsrDictEx

Load a user dictionary instance into memory.

TTSRETVAL TtsLoadUsrDictEx (

 HTTSINSTANCE hTtsInst,

 const TTS_USRDICT_DATA* pUsrDictData,

 HTTSUSRDICT* phUsrDict)

The dictionary is implicitly enabled with the default priority. (See TtsEnableUsrDictEx for making dictionaries explicitly enabled with a chosen priority.)

Each dictionary instance is initialized with the default (lowest) priority. All dictionary instances must have a different priority (except the default priority, which can be used by several dictionaries). The priority can be set by TtsEnableUsrDictEx. If two dictionaries have the default priority, the dictionary that is last loaded has the ‘highest’ priority. This means that when a token has to be processed, a lookup will take place using the last loaded dictionary first.

Argument	Description
hTtsInst	[in] Handle to a TTS engine instance.
pUsrDictData	[in] Const pointer to a dictionary properties description.
phUsrDict	[out] Handle to a dictionary instance.

The order in which dictionaries are looked up can be changed by using TtsEnableUsrDictEx and setting the priority to a different value.