cc_GetInfoElem( ) gets information elements associated with a line device
122
Name:
int cc_GetInfoElem(linedev, iep)
Reference:
LINEDEV linedev
• line device handle of the B channel
board
Inputs:
IE_BLK *iep
• pointer to the information element
buffer
Returns:
0 on success
< 0 on failure
Includes:
cclib.h
Category:
Optional call handling
Mode:
synchronous
Technology:
BRI/SC; PRI (all protocols)
!
! !
!
Description
The cc_GetInfoElem( ) function gets information elements associated with a line
device for an incoming message. The cc_GetInfoElem( ) 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.
Parameter Description
linedev:
The B channel board line device handle.
iep:
The starting address of the information element block. The
information elements are contained in the IE_BLK data
structure. See Section 6.6. IE_BLK for a description of the data
structure. See the example code for details.
!
! !
!
Caution
• This function is not supported for the BRI/2 board.
• The CCEV_NOFACILITYBUF event will be received by the application for
every incoming ISDN message that contains the Network Facility IE. The
event is received because the first four IEs are stored in the ISDN library and
the remaining ones are discarded. The CCEV_NOFACILITYBUF event can
be ignored. The IE can be retrieved using the cc_GetCallInfo(U_IES)
function or the cc_GetInfoElem( ) function. The ability to retrieve just the