vceLoadPromptRules

Loads the specified prompt rules table.

Prototype

DWORD vceLoadPromptRules ( CTAHD ctahd, char *name, VCEPROMPTHD *prompthandle)

Argument

Description

ctahd

Handle returned by ctaCreateContext or ctaAttachContext.

name

Pointer to the file name of the prompt rule table. If the file does not include an extension, the default extension of .tbl is added to the file name.

prompthandle

Pointer to the integer variable to receive the handle of the specified prompt table.


Return values

Return value

Description

SUCCESS

 

CTAERR_FILE_ACCESS_DENIED

Another application process or thread in the system may have the file open for recording.

CTAERR_FILE_NOT_FOUND

Specified file does not exist.

CTAERR_INVALID_CTAHD

Context handle is invalid.

CTAERR_SVR_COMM

Server communication error.


Details

vceLoadPromptRules reads the specified prompt rules table into memory. The returned prompt handle is passed to vceBuildPromptList.

Open the associated voice file using vceOpenFile. The voice file is used with the output from vceBuildPromptList to call vcePlayList.

Each rule table is usually specific to one language such as French, German, or English. More than one rule table can be loaded at a time.

See also

vceUnloadPromptRules

Example

Refer to vceBuildPromptList.