2.15. gc_GetUserInfo( )

When using Springware boards, 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.

Note: Since the gc_GetUserInfo( ) function does not queue any information, use of this function is not recommended.

When using DM3 boards, the gc_GetUserInfo( ) function is not supported.

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 Global Call 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 Telecom Support Resources