accepts a connection request from the remote end cc_AnswerCall( )
53
Name: int cc_AnswerCall(crn, rings, mode)
Inputs: CRN crn • call reference number
int rings • number of rings before return
unsigned long mode • synchronous or asynchronous
Returns: 0 on success
< 0 on failure
Includes: cclib.h
Category Call control
Mode: synchronous or asynchronous
Technology: BRI/2; BRI/SC; PRI (all protocols)
!
! !
!
Description
The cc_AnswerCall( ) function accepts a connection request from the remote end
and connects the call. This function is equivalent to a conventional “offhook”
command in answering an incoming call. The cc_AnswerCall( ) function is used
any time after:
• CCEV_OFFERED, CCEV_PROGRESSING, or CCEV_ACCEPT is
received in asynchronous mode
• the successful completion of cc_WaitCall( ) in synchronous mode
In asynchronous mode, the CCEV_ANSWERED event indicates successful
completion of the cc_AnswerCall( ) function. After the successful completion of
the function call, the call state changes from Offered or Accepted, if
cc_AcceptCall( ) was used, to Connected.
Parameter Description
crn: The call reference number. Each call needs a CRN.
rings: Specifies how long the protocol handler will wait before
returning to the calling entity. In ISDN systems, rings must
be set to zero or an error will be returned.
Mode: Specifies asynchronous (EV_ASYNC) or synchronous
(EV_SYNC) mode.