2.14. gc_GetUserInfo( )

The gc_GetUserInfo( ) function gets unprocessed information elements in the CCITT format. The gc_GetUserInfo( ) 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.

The following table provides the parameter inputs for the gc_GetUserInfo( ) function.

Parameter	Input
target_type	GCTGT_GCLIB_NETIF, GCTGT_GCLIB_CHAN, GCTGT_GCLIB_CRN
target_id	need input
infoparmblkp	set ID - GCIS_SET_IE, parm ID - GCIS_PARM_UIEDATA

Termination Event

None

Cautions

• This function returns with an error if the GlobalCall application has set GCIS_PARM_RECEIVEINFOBUF. To retrieve unprocessed IEs, the application should use gc_Extension(GCIS_EXID_GETSIGINFO).
• This function is not supported for BRI/2 board.

Example

 #include "gclib.h"
#include "gcerr.h"
#include "gcisdn.h"
 int GetUserInfo(LINEDEV linedev)
{
   IE_BLK ie_blk;
   GC_PARM_BLK infoparm;
   int retcode;
    infoparm.pstruct = (void *)&ie_blk;
    retcode=gc_GetUserInfo(GCTGT_GCLIB_CHAN, linedev, &infoparm);
    return retcode;
}

Click here to contact Dialogic Customer Engineering