Dialogic Global Call IP Benutzerhandbuch

Seite von 604
406
Dialogic
®
 Global Call IP Technology Guide — November 2007
Dialogic Corporation
gc_RejectModifyCall( ) — reject proposed modification of call attributes
gc_RejectModifyCall( )
reject proposed modification of call attributes
„ Description
The gc_RejectModifyCall( ) function is used to reject a request from the network or remote party 
to change an attribute of the current call.
This function initiates a 3xx thorough 6xx response code to an incoming re-INVITE request, as 
indicated by an incoming GCEV_REQ_MODIFY_CALL event on the respective call object. The 
actual response code that is sent is specified by the reason parameter.   
The function returns either <0 (to indicate failure) or 0, depending only upon the validity of the 
parameters. The function return does not indicate any status as to the success or failure of the 
sending of the rejection response message. The final result of sending the response is provided to 
the application in termination events.
„ Termination Events 
GCEV_REJECT_MODIFY_CALL
Successful termination event. Indicates that rejection of the received re-INVITE request has 
completed successfully. This event implies that the specified 3xx through 6xx response was 
sent and that an ACK was received from the remote party. In 1PCC mode, the requested call 
Name:
int gc_RejectModifyCall (crn, reason, mode)
Inputs:
CRN crn
call reference number of call targeted for modification
unsigned long reason
reason for rejecting request to change call attribute
unsigned long mode
completion mode (EV_ASYNC)
Returns:
0 if successful
<0 if unsuccessful
Includes:
gclib.h
Category:
Call Modification
Mode:
Asynchronous only
Parameter
Description
crn 
call reference number of the call targeted for modification; must match the 
CRN contained in the GCEV_REQ_MODIFY_CALL event
reason 
the reason for rejecting the request to modify call attributes, specified 
using the IPEC_SIPReasonStatusXXX… symbolic defines for SIP reason 
codes from 300 through 699. These symbols are defined in gcip_defs.h 
and are listed in 
mode 
must be EV_ASYNC