cc_SetInfoElem( ) sets additional information elements
238
Name:
int cc_SetInfoElem(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/2; BRI/SC; PRI (all protocols)
!
! !
!
Description
The cc_SetInfoElem( ) function sets additional information elements, allowing
the application to include application-specific ISDN information elements in the
next outbound message. This function is used for rapid deployment of an
application that “interworks” with the network to take advantage of ISDN's
capabilities. A typical application is user-to-user information elements in each
outgoing message.
NOTE:
See Appendix C for descriptions of ISDN IEs that are specific to the
DPNSS protocol.
Parameter Description
linedev:
The B channel board line device handle.
iep:
The starting address of the information element block (IE_BLK).
For a description of the IE_BLK data structure, see Section
6.6. IE_BLK. See the Example code for details.
!
! !
!
Cautions
• This function must be used immediately before calling a function that sends
an ISDN message. The information elements specified by this function are
applicable only to the next outgoing ISDN message.
• The line device handle in the parameter must be the same as the one used in
the function call that sends the ISDN message.
• The IE data length must not exceed MAXLEN_IEDATA of 254 bytes.