Dialogic 05-0867-005 Table Top Game User Manual


 
cc_RetrieveAck( ) accept a request to retrieve a call from hold
204
Name:
int cc_RetrieveAck(crn)
Inputs:
CRN crn
call reference number
Returns:
0 on success
<0 on failure
Includes:
cclib.h
Category:
Hold and Retrieve
Mode:
synchronous
Technology:
BRI/2; BRI/SC; PRI (Q.SIG only)
!
! !
!
Description
The cc_RetrieveAck( ) function allows the application to accept a request to
retrieve a call from hold from remote equipment. The call must be in the Hold
state and the CCEV_RETRIEVECALL event must be received before the
function is called.
Parameter Description
crn:
The call reference number. Each call needs a CRN.
!
! !
!
Cautions
The BRI protocols and the PRI Q.SIG protocol are the only protocols that
allow the retrieval of a call in the Hold state to be accepted or rejected. The
cc_RetrieveAck( ) function cannot be used in the DPNSS protocol or any
PRI protocol other than Q.SIG.
The cc_RetrieveAck( ) function is valid only after the call is in the Hold state
and after the CCEV_RETRIEVECALL event is received.
!
! !
!
Example
#include <windows.h> /* For Windows applications only */
#include <stdio.h>
#include <errno.h>
#include <srllib.h>
#include <dtilib.h>
#include <cclib.h>
main()
{
char *devname = dtiB1T1;
LINEDEV ldev;