TextToSpeechLoadUserDictionary
| Syntax
| MMRESULT TextToSpeechLoadUserDictionary
| (LPTTS_HANDLE_T phTTS,
LPSTR pszFileName) |
| Parameters
| LPTTS_HANDLE_T phTTS
| Specifies a text-to-speech handle.
|
|
| LPSTR pszFileName
| Points to a NULL terminated string that specifies the name of the user
dictionary file to be loaded.
|
| Return Value
| This call returns a value of type MMRESULT. The return value is zero if the
call is successful. The return value is one of the following constants:
|
| Constant
| Description
|
| MMSYSERR_NOERROR
| Normal successful completion (zero).
|
| MMSYSERR_INVALHANDLE
| The text-to-speech handle was invalid.
|
| MMSYSERR_NOMEM
| Unable to allocate memory for dictionary.
|
| MMSYSERR_INVALPARAM
| Dictionary file not found or an invalid dictionary file name.
|
| MMSYSERR_ERROR
| Illegal dictionary format or a dictionary is already loaded.
|
|
|
|
| Comments
| This call loads a dictionary created by the windict or userdict applet. Any
previously loaded user dictionary must be unloaded before loading a new user
dictionary. Note that the text-to-speech system will automatically load a user
dictionary, user.dic, at startup if it exists in the home directory.
|
| See Also
| Dictionary Functions (UNIX)
Dictionary Functions (Windows) TextToSpeechUnloadUserDictionary |