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.