Voice-Command Error Values

The following table shows the errors that can be returned by methods of the voice command objects. If no error occurs, the functions return NOERROR.

Error value
Description
VCMDERR_CANNOTMIMIC No command was found to match the input string.
VCMDERR_CANTCREATEAUDIODEVICE An audio source object cannot be created for speech recognition.
VCMDERR_CANTCREATEDATASTRUCTURES The internal data structures needed to build a grammar cannot be created.
VCMDERR_CANTCREATESRENUM A speech recognition enumerator object cannot be created.
VCMDERR_CANTCREATESTORAGE Space cannot be created in the database for the menu.
VCMDERR_CANTINITDATASTRUCTURES The internal data structures needed to build a grammar cannot be initialized.
VCMDERR_CANTSELECTENGINE A speech recognition engine cannot be selected.
VCMDERR_CANTSETDEVICE The device identifier cannot be set into the audio source object.
VCMDERR_CANTXTRACTWORDS The unique words needed by the engine grammar object cannot be extracted.
VCMDERR_INVALIDCHAR There is an invalid character in the voice menu.
VCMDERR_INVALIDLIST There was an invalid list passed to IVCmdMenu::ListSet or IVCmdMenu::ListGet.
VCMDERR_INVALIDMODE No site exists, the site does not support this attribute, or the voice command object is already registered with a site.
VCMDERR_INVALIDWINDOW The window is invalid.
VCMDERR_MENUACTIVE The menu is currently active and cannot be deleted.
VCMDERR_MENUDOESNOTEXIST The requested menu does not exist in the database.
VCMDERR_MENUEXIST The requested new or temporary menu already exists in the database.
VCMDERR_MENUOPEN The menu exists but has not been released, so it cannot be deleted.
VCMDERR_MENUTOOCOMPLEX The menu is too complex to use.
VCMDERR_MENUWRONGLANGUAGE The language is not supported by the speech recognition engine.
VCMDERR_NOCACHEDATA There is no internal cache entry for this menu.
VCMDERR_NOCOMMANDS The menu is active, but the menu does not yet contain any commands.
VCMDERR_NOENGINE No speech recognition engine is active.
VCMDERR_NOFINDINTERFACE The speech recognition enumerator interface does not have a Find interface.
VCMDERR_NOGRAMMARINTERFACE No engine grammar object is available.
VCMDERR_NOSITEINFO Information to open this site is not available.
VCMDERR_NOTSUPPORTED The function is not supported by the engine.
VCMDERR_OUTOFDISK No disk space is left to write information.
VCMDERR_OUTOFMEM There is no more memory.
VCMDERR_SRFINDFAILED The speech recognition object could not find an appropriate mode.
VCMDERR_TOOMANYMENUS There are too many active menus.
VCMDERR_VALUEOUTOFRANGE The value is out of range.

In addition to the error values described in the preceding list, methods can return error values generated by lower-level component objects or calls to the Win32 API.