Dialogic 05-0867-005 Table Top Game User Manual


 
retrieves the network call reference value cc_GetNetCRV( )
131
Name:
int cc_GetNetCRV(crn, netcrvp)
Inputs:
CRN crn
call reference number
int *netcrvp
pointer to network call reference buffer
Returns:
0 on success
< 0 on failure
Includes:
cclib.h
Category:
System tools
Mode:
synchronous
Technology:
BRI/SC; PRI (all protocols)
!
! !
!
Description
The cc_GetNetCRV( ) function retrieves the network call reference value (CRV)
for a specified call reference number (CRN). The CRN is assigned during either
the cc_MakeCall( ) function for outbound calls or the cc_WaitCall( ) function
for incoming calls. If an invalid host CRN value is passed, for example, the CRN
of an inactive call, cc_GetNetCRV( ) will return a value < 0 indicating failure.
NOTE:
The cc_GetNetCRV( ) function can be used to invoke the Two B
Channel Transfer (TBCT) feature. The TBCT feature is invoked by
sending a FACILITY message to the Network containing, among other
things, the Call Reference Values (CRVs) of the two calls to be
transferred. See Appendix A - Call Control Scenarios for more
information on TBCT.
Parameter Description
crn:
The call reference number. Each call needs a CRN.
netcrvp:
The pointer to the buffer where the network call reference
value (CRV) will be stored.
!
! !
!
Cautions
This function is not supported for the BRI/2 board.
!
! !
!
Example
#include <windows.h> /* For Windows applications only */
#include <stdio.h>
#include <errno.h>