Filter
Top Products
428 Dialogic
®
Global Call IP Technology Guide — November 2007
Dialogic Corporation
gc_util_copy_parm_blk( ) — copy the specified GC_PARM_BLK
gc_util_copy_parm_blk( )
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.
Name: int gc_util_copy_parm_blk(parm_blkpp, parm_blkp)
Inputs: 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
Returns: GC_SUCCESS if successful
GC_ERROR if unsuccessful
Includes: gclib.h
gcerr.h
Category: GC_PARM_BLK utility
Mode: synchronous
Parameter Description
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