Dialogic Dialogic Global Call IP IP Phone User Manual


 
Dialogic
®
Global Call IP Technology Guide — November 2007 529
Dialogic Corporation
IP-Specific Parameters
9.2.23 IPSET_SIP_MSGINFO
Table 65 shows the parameter IDs in the IPSET_SIP_MSGINFO parameter set. Note that access to
SIP message header info fields is disabled by default and must be explicitly enabled by setting the
IP_SIP_MSGINFO_ENABLE mask value in the sip_msginfo_mask field of the IP_VIRTBOARD
structure before starting the virtual board.
Notes: 1. All parameter IDs in this parameter set are deprecated except IPPARM_SIP_HDR. The
deprecated parameter IDs will remain in the IP Call Control Library for backward compatibility,
but there will be no further development in relation to these parameter IDs.
2. All of the MAXLEN defines for the deprecated SIP header fields are equated to 255 bytes.
3. The maximum data length for the IPPARM_SIP_HDR parameter ID is not limited to 255 bytes.
Applications using this parameter ID must use the “extended” gc_util_..._ex( ) utility functions,
which are capable of handling parameter data longer than 255 bytes.
Table 64. IPSET_SDP Parameter Set
Parameter IDs
Data Type &
Size
Description
SIP/
H.323
IPPARM_
SDP_ANSWER
Type: string †
Max length: †
Identifies parameter data as an SDP answer. SIP
3PCC
only
IPPARM_
SDP_OFFER
Type: string †
Max. length: †
Identifies parameter data as an SDP offer. SIP
3PCC
only
IPPARM_
SDP_OPTION_
ANSWER
Type: string †
Max. length: †
Identifies parameter data as an SDP answer being
exchanged in an OPTIONS transaction (e.g., outside a
dialog)
SIP
3PCC
only
IPPARM_
SDP_OPTION_
OFFER
Type: string †
Max. length: †
Identifies parameter data as an SDP offer being
exchanged in an OPTIONS transaction (e.g., outside a
dialog)
SIP
3PCC
only
† For parameters with data of type String, the length in a GC_PARM_BLK is the length of the data string plus 1.
‡ The maximum data size for all parameters in this set is defined by the max_parm_data_size parameter that is set in the
IPCCLIB_START_DATA structure before the system is started.
Table 65. IPSET_SIP_MSGINFO Parameter Set
Parameter IDs Data Type & Size Description
SIP/
H.323
IPPARM_CALLID_HDR
(deprecated)
Type: string †
Size: max length =
IP_CALLID_HDR_MAXLEN
Deprecated parameter to set or
retrieve the Call-ID header field
in SIP messages.
Note: This parameter overrides
any Call-ID value set via
IPSET_CALLINFO/
IPPARM_CALLID.
SIP
only
For parameter s with data of type String, the length in a GC_PARM_BLK is the length of the data string plus 1.