Dialogic 05-2239-009 User Manual

Page of 604
279
Dialogic Corporation
conventional nonstandard messages; see 
An unsolicited GCEV_EXTENSION event with an extension ID (ext_id) of 
IPEXTID_RECEIVEMSG can be received that contains a nonstandard registration message. The 
associated GC_PARM_BLK contains the message details in parameter elements as follows: 
The parameter element that identifies the message type is: 
IPSET_MSG_REGISTRATION
IPPARM_MSGTYPE
value = IP_MSGTYPE_REG_NONSTD
The parameter element for the Nonstandard Data data is:
IPSET_NONSTANDARDDATA
IPPARM_NONSTANDARDDATA_DATA
value = Nonstandard Data string, max length = max_parm_data_size (configurable at 
library start-up)
The parameter element for the Nonstandard Data identifier is one (and only one) of the following:
IPSET_NONSTANDARDDATA
IPPARM_NONSTANDARDDATA_OBJID
value = array of unsigned integers, max length = MAX_NS_PARM_OBJID_LENGTH 
IPSET_NONSTANDARDDATA
IPPARM_H221NONSTANDARD
value = IP_H221NONSTANDARD structure
The maximum length of the Global Call parameter used for the Nonstandard Data information is 
configured at start-up via the max_parm_data_size field in the IPCCLIB_START_DATA structure. 
The default size is 255 (for backwards compatibility), but applications may configure it to be as 
large as 4096 bytes. Applications must use the extended gc_util_..._ex( ) functions to insert or 
extract any GC_PARM_BLK parameter elements whose data length is defined to be greater than 
255. 
Note:
In practice, applications may not be able to utilize the full maximum length of the nonstandard data 
parameter element as configured in max_parm_data_size. The H.323 stack limits the overall size of 
messages to be max_parm_data_size + 512 bytes, and any messages that exceed this limit are 
truncated without any notification to the application.
4.22.4
Registration Code Examples 
This section contains code examples illustrating SIP registration and deregistration.