Dialogic IP Phone 05-2239-009 User Manual

439

Dialogic Corporation

initialize GC_PARM_DATA_EXT structure

„ Description

The INIT_GC_PARM_DATA_EXT( ) function is used to initialize a 

GC_PARM_DATA_EXT

 

data structure, which is used when retrieving parameter elements from the metaevent data 
associated with many Global Call events using gc_util_find_parm_ex( ) and 
gc_util_next_parm_ex( ) functions. These functions use the GC_PARM_DATA_EXT structure in 
order to handle extended-length parameter values (>255 bytes), but always use this structure 
regardless of the actual length of the parameter value.

Applications must use this function to initialize the GC_PARM_DATA_EXT structure before 
calling gc_util_find_parm_ex( ) or before the initial call to gc_util_next_parm_ex( ). 

„ Cautions

Failure to use this function to initialize the GC_PARM_DATA_EXT structure before calling 
gc_util_find_parm_ex( ) or before the initial call to gc_util_next_parm_ex( ) may cause an 
operational error.

„ Example

#include "gclib.h"
#include "gcip.h"

void process_parm_block(GC_PARM_BLKP pparm_blk) 
{
   GC_PARM_DATA_EXT parm_data_ext;
   int ret = 0;

   /* Initialize this structure for two reasons:
    * 1. To retrieve the first parameter in the parm block
    * 2. The first time this structure is used it must be initialized
    */
   INIT_GC_PARM_DATA_EXT(&parm_data_ext);

   /* Loop to retrieve all of the parameters and associated data from the GC_PARM_BLK
    */
   while ( GC_SUCCESS == (ret = gc_util_next_parm_ex( pparm_blk, &parm_dat_ext)) )
   {
      /* Process set_ID/parm_ID pairs */

void INIT_GC_PARM_DATA_EXT(pData)

GC_PARM_DATA_EXT *pData

pointer to the structure to be initialized

None

gcip.h

synchronous

pData 

points to the GC_PARM_DATA_EXT structure to be initialized