retrieve a call from the Hold state cc_RetrieveCall( )
207
Name: int cc_RetrieveCall(crn, mode)
Inputs: CRN crn • call reference number
unsigned long mode • synchronous or asynchronous
Returns: 0 on success
<0 on failure
Includes: cclib.h
Category: Hold and Retrieve
Mode: synchronous or asynchronous
Technology: BRI/2; BRI/SC; PRI (DPNSS and Q.SIG only)
!
! !
!
Description
The cc_RetrieveCall( ) function allows the application to retrieve a call from the
Hold state. The call must be in the Hold state to use this function.
Parameter Description
crn: The call reference number. Each call needs a CRN.
mode: Specifies synchronous (EV_SYNC) or asynchronous
(EV_ASYNC) mode.
!
! !
!
Termination Events
• CCEV_RETRIEVEACK - indicates that the call has been retrieved from
Hold state
• CCEV_RETRIEVEREJ - indicates that the retrieve request was rejected by
the firmware or remote equipment
!
! !
!
Cautions
The cc_RetrieveCall( ) function can only be used when the call is in Hold state.
!
! !
!
Example
#include <windows.h> /* For Windows applications only */
#include <stdio.h>
#include <errno.h>
#include <srllib.h>
#include <dtilib.h>
#include <cclib.h>