Dialogic Global Call IP Manual Do Utilizador

428

Dialogic Corporation

copy the specified GC_PARM_BLK

„ Description

The gc_util_copy_parm_blk( ) function copies the specified GC_PARM_BLK. 

This function must be used to copy any GC_PARM_BLK that contains any parameter elements 
(setID/parmID pairs) that can have data that is potentially larger than 255 bytes. This function can 
be used for any GC_PARM_BLK, regardless of whether it contains setID / parmID pairs that 
support parameter data lengths greater than 255 bytes. 

Only specific Global Call parameters support values longer than 255 bytes and therefore require 
the use of this function. The parameters that currently support extended-length values include:

IPSET_MIME (or IPSET_MIME_200OK_TO_BYE) / IPPARM_MIME_PART_HEADER 

IPSET_MIME (or IPSET_MIME_200OK_TO_BYE) / IPPARM_MIME_PART_TYPE

IPSET_NONSTANDARDCONTROL / IPPARM_NONSTANDARDDATA_DATA

IPSET_NONSTANDARDDATA / IPPARM_NONSTANDARDDATA_DATA

IPSET_SDP / all four parameter IDs (supported in 3PCC operating mode only)

IPSET_SIP_MSGINFO / IPPARM_SIP_HDR

IPSET_TUNNELEDSIGNALMSG / IPPARM_TUNNELEDSIGNALMSG_DATA

„ Cautions

To avoid a memory leak, any GC_PARM_BLK created must eventually be deleted using the 
gc_util_delete_parm_blk( ) function.

int gc_util_copy_parm_blk(parm_blkpp, parm_blkp)

GC_PARM_BLKP* parm_blkpp

pointer to the address of the new GC_PARM_BLK

GC_PARM_BLKP parm_blkp

pointer to a valid GC_PARM_BLK to be copied 

GC_SUCCESS if successful
GC_ERROR if unsuccessful

gclib.h
gcerr.h

GC_PARM_BLK utility

synchronous

parm_blkpp 

pointer to the address of the new GC_PARM_BLK that the specified parm 
block will be copied to; must be set to NULL 

parm_blkp 

points to a valid, existing GC_PARM_BLK to be copied