Voice-Command Error Values

The following errors may be returned by functions 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 ListSet or 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_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

Site 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, member functions can return error values generated by lower-level component objects or calls to the Win32 API. For example, an IVoiceCmd function might return an AUDERR_ value generated by the audio source object. For more information, see "Object Levels and Error Values".