Dialogic® Global Call API Library Reference

gc_InitXfer( ) — initiate a supervised transfer
Additional result values for GCEV_INIT_XFER_REJ include:
GCRV_REMOTEREJ_NOTALLOWED
remote rejected; service not allowed
GCRV_REMOTEREJ_NOTSUBSCRIBED
remote rejected; user is not subscribed
GCRV_REMOTEREJ_UNAVAIL
remote rejected; service unavailable
GCRV_REMOTEREJ_UNSPECIFIED
remote rejected; reason not given
Example
#include
#include
#include
#include
#include
#include
#define MAX_CHAN 30 /* maximum number of channels in system */
/*
* Data structure which stores all information for each line
*/
static struct linebag {
LINEDEV ldev; /* Global Call API line device handle */
CRN crn; /* Global Call API call handle */
CRN consultation_crn; /* Global Call API call handle */
int blocked; /* channel blocked/unblocked */
} port[MAX_CHAN+1];
struct linebag *pline; /* pointer to access line device */
/*
* Assume the following have been done:
* 1. Opened line devices for each time slot on the network interface board.
* 2. Each line device is stored in linebag structure "port".
* 3. The consultation call has been established between Transferring party A and
* Transferred-To party C and the call is in connected or on hold state.
*/
int initiate_calltransfer(int port_num)
{
GC_INFO gc_error_info; /* Global Call error information data */
GC_PARM_BLK * gc_pRetParmBlk = NULL; /* Returned the GC_PARM_BLK */
}
/* Find info for this time slot, specified by 'port_num' */
/* (assumes port_num is valid) */
pline = port + port_num;
/* Initiate the call transfer request */
if (gc_InitXfer(pline->crn, &gc_pRetParmBlk, NULL, EV_ASYNC) == -1)
{
/* process error return as shown */
gc_ErrorInfo( &gc_error_info );
printf ("Error: gc_InitXfer() on device handle: 0x%lx, GC ErrorValue: 0x%hx - %s,
CCLibID: %i - %s, CC ErrorValue: 0x%lx - %s\n", pline->ldev,
gc_error_info.gcValue, gc_error_info.gcMsg, gc_error_info.ccLibId,
gc_error_info.ccLibName, gc_error_info.ccValue, gc_error_info.ccMsg);
return (gc_error_info.gcValue);
}
return (0);
212 Dialogic ® Global Call API Library Reference — January 2008
Dialogic Corporation