Filter
Top Products
Dialogic
®
Global Call IP Technology Guide — November 2007 439
Dialogic Corporation
initialize GC_PARM_DATA_EXT structure — INIT_GC_PARM_DATA_EXT( )
INIT_GC_PARM_DATA_EXT( )
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 */
Name: void INIT_GC_PARM_DATA_EXT(pData)
Inputs: GC_PARM_DATA_EXT *pData
• pointer to the structure to be initialized
Returns: None
Includes: gcip.h
Mode: synchronous
Parameter Description
pData points to the GC_PARM_DATA_EXT structure to be initialized