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>