Filter
Top Products
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 Section 11.5, “Failure Response Codes When Using SIP”,
on page 584.
mode must be EV_ASYNC