LVCA_SetUserData

Sets a call's User Data pointer.

LVCA_API BOOL WINAPI LVCA_SetUserData(HANDLE hCA, LPVOID Param);

Return Value:

This function return true if successful, otherwise false will be returned.  Call LVCA_GetLastCallError to retrieve the error An Error is anything within the system itself that creates a glitch in the Speech Driven Information System An Information System is a general term used to describe the product you are designing with this software. This could be any type of system in which you can give information to your callers, such as a Virtual Customer Service Center, a Virtual Technical Support Center, or a Virtual Help Desk., such as a missing Vox A Vox is an Action that plays a sound file. You can record a Vox in your own voice directly from the Speech Driven Information System. You can also use the Audio Manager to import recordings or sound effects that you have obtained from other sources. or a Goto A Goto is an Action that sends callers to another Module. A Goto is a Terminal Action. This means it will be the last Action in an Actions List. that doesn't go anywhere. code and message.

Supported on Events:

CAMSG_CALLSTART

CAMSG_CALLSTOP

CAMSG_ENTERMODULE

CAMSG_REC_BEFORE_CONFIRM

CAMSG_REC_AFTER_CONFIRM

CAMSG_TIMEOUT CAMSG_ERROR

Params:

hCA (IN) The handle given by the event callback.

Param (OUT) The pointer which the call’s User Data will be set to.

Notes:

The LVCA_SetUserData function will set the call's User Data equal to the passed parameter.  This User Data pointer can be retrieved by the function LVCA_GetUserData.  The most appropriate place to use this function is the user defined function LV_Call_Start.  That is the first function called by the Call Handler A Handler is an Action An Action is a specific command that you can add to an Action List. There are five types of Actions: Vox, Listen, Goto, Transfer, and Hangup. List that goes into effect when a No Input A No Input occurs when the system is expecting a response and the caller doesn't say anything., No Match A No Match occurs when the caller says something the system doesn't recognize. For example, if the system asks the caller "Do you prefer coffee or tea?" and they reply "Juice," their response would be considered a No Match., or Error occurs. when a call is answered.  Each DLL specified in a module Modules are the individual elements you use to create your Information System. When you create an Information System, you are crafting a conversation between a computer and a live person. Each Module represents a single, distinct portion of that conversation. The different types of Modules are: Start, List, Multilevel, Overview, Yes/No, Goto, Hangup A Hangup is an Action that will hang up on callers. A Hangup is a Terminal Action. This means it will be the last Action in an Actions List., Transfer A Transfer is an Action that will hang up on callers. A Transfer is a Terminal Action. This means it will be the last Action in an Actions List., Global, Global Yes/No and Goto Project Each Project you create represents a single Speech Driven Information System. So, if you want to create three separate Information Systems, you will need to create three different Projects.. Each Module has its own unique function and symbol. will have its LV_Call_Start function called.  When a call ends the LV_Call_End function will be fired in each DLL which is specified in the call flow.  Clean up work which must be done, should be performed there.


Complete Help Topic List | Speech Platform Product Information