Dialogic 05-0867-005 Table Top Game User Manual


 
gets the information elements associated with the CRN cc_GetCallInfo( )
89
Name:
cc_GetCallInfo(crn, info_id, valuep)
Inputs:
CRN crn
call reference number
int info_id
call information identifier
char *valuep
pointer to information buffer
Returns:
0 on success
< 0 on failure
Includes:
cclib.h
isdnlib.h
Category:
Optional call handling
Mode:
synchronous
Technology:
BRI/2; BRI/SC; PRI (all protocols)
!
! !
!
Description
The cc_GetCallInfo( ) function gets the information elements associated with the
CRN of an incoming message. The cc_GetCallInfo( ) function must be used
immediately after the message is received if the application requires the call
information. The library will not queue the call information; subsequent messages
on the same line device will be discarded if the previous messages are not
retrieved.
NOTE:
For new applications, use the cc_GetSigInfo( ) function instead of
cc_GetCallInfo( ). The cc_GetSigInfo( ) function allows buffers to be
set up, which enables the application to store and retrieve multiple
messages.
Parameter Description
crn:
The call reference number. Each call needs a CRN.
info_id:
The call information identifier (see Table 19 below).
valuep:
Points to the buffer where the call information will be stored.
The following table provides definitions of possible info_id parameters.