2.33. gc_SetUserInfo( )

The gc_SetUserInfo( ) function is used to set 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 D, "DPNSS IEs and Message Types", for descriptions of ISDN IEs that are specific to the DPNSS protocol.

The duration parameter should be set to C_SINGLECALL - The information elements specified by this function are applicable only to the next outgoing ISDN message.

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 linedevice handle in the parameter must be 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.

Example

 #include "gclib.h"
 #include "gcerr.h"
 #include "gcisdn.h" 
 int SetUserInfo(LINEDEV linedev)
 {
    char ie_blk;
    GC_PARM_BLKP infoparm = NULL;
    int retcode; 
    ie_blk[0] = (char)0xa1; //Sending complete IE 
    gc_util_insert_parm_ref(&infoparm, GCIS_SET_IE, GCIS_PARM_IEDATA, 1,
         &ie_blk);
    retcode=gc_SetUserInfo(GCTGT_GCLIB_CHAN, linedev, infoparm, \
        GC_SINGLECALL); 
    return retcode;
 } 

Click here to contact Telecom Support Resources