3.1.18. gc_SetUserInfo( )

The gc_SetUserInfo( ) function can be used to:

• Set call values for the duration of a single call
• Set call values for all calls on the specified line device

Setting Call Parameters for a Single Call

The pertinent function parameter values in this context are:

• target_type - GCTGT_GCLIB_CHAN
• target_id - the line device
• duration - GC_SINGLECALL
• infoparmblkp - a pointer to a GC_PARM_BLK with a list of parameters to be set for the line device. Table 4 describes the set ID and parameter ID values that can be used in this context and indicates when the data is used.

Table 4. Call Parameters Configurable using gc_SetUserInfo( )

Set ID	Parameter IDs	When Used*
GCSET_CHAN_CAPABILITY	IPPARM_LOCAL_CAPABILITY Datatype: IP_CAPABILITY. See Section 7.2, "IP_CAPABILITY" for more information.	gc_AnswerCall( ) gc_MakeCall( )
IPSET_CALLINFO See Section 6.2, "IPSET_CALLINFO Parameter Set" for more information.	IPPARM_DISPLAY Datatype: String	gc_AnswerCall( ) gc_MakeCall( )
	IPPARM_USERUSER_INFO Datatype: Uint8[ ]	gc_MakeCall( )
	IPPARM_PHONELIST Datatype: String	gc_MakeCall( )
IPSET_NONSTANDARDDATA See Section 6.6, "IPSET_NONSTANDARDDATA Parameter Set" for more information.	IPPARM_NONSTANDARDDATA_OBJID Datatype: String	gc_AnswerCall( ) gc_MakeCall( ) gc_DropCall( )
	IPPARM_NONSTANDARDDATA_DATA Datatype: String	gc_AnswerCall( ) gc_MakeCall( ) gc_DropCall( )
* Information can be set in any state but it is only used in certain states. If information is set after it can be used, and the duration parameter is set to GC_SINGLECALL, the information settings are ignored.

Setting Call Parameters for a Line Device

When the duration parameter is set to GC_ALLCALLS, the new call values become the default values for the line device and are used for all subsequent calls on that device. The pertinent function parameter values in this context are:

• target_type - GCTGT_GCLIB_CHAN
• target_id - the line device
• duration - GC_ALLCALLS
• infoparmblkp - a pointer to a GC_PARM_BLK with the coder information to be set for the line device. Table 5 describes the set ID and parameter ID values that can be used in this context.

Table 5. Line Device Parameters Configurable using gc_SetUserInfo( )

Set ID	Parameter IDs
GCSET_CHAN_CAPABILITY	IPPARM_LOCAL_CAPABILITY Datatype: IP_CAPABILITY. See Section 7.2, "IP_CAPABILITY" for more information.

Click here to contact Telecom Support Resources