Dialogic Dialogic Global Call IP IP Phone User Manual


 
Dialogic
®
Global Call API Library Reference — November 2007 551
Dialogic Corporation
TSM protocol alternate ID — IP_TUNNELPROTOCOL_ALTID
IP_TUNNELPROTOCOL_ALTID
TSM protocol alternate ID
typedef struct
{
unsigned long version;
char protocolType[MAX_TSM_ALTID_VARS_LENGTH];
int protocolTypeLength;
char protocolVariant[MAX_TSM_ALTID_VARS_LENGTH];
int protocolVariantLength;
char subIdentifier[MAX_TSM_ALTID_VARS_LENGTH];
int subIdentifierLength;
} IP_TUNNELPROTOCOL_ALTID;
Description
The IP_TUNNELPROTOCOL_ALTID data structure is used in H.323 Annex M tunneled
signaling to identify the protocol using alternate ID information. This data structure is used as the
value of a Global Call parameter element of type IPSET_TUNNELEDSIGNALMSG /
IPPARM_TUNNELEDSIGNALMSG_ALTERNATEID. This data structure is not used when the
tunneled signaling message uses a protocol object ID to identify the protocol.
Applications should use the INIT_IP_TUNNELPROTOCOL_ALTID( ) function to initialize
the structure with the correct version number and initial field values.
Field Descriptions
The fields of the IP_TUNNELPROTOCOL_ALTID data structure are described as follows:
version
the version number of the data structure; the correct value is set by the
INIT_IP_TUNNELPROTOCOL_ALTID( ) initialization function and should not be
overridden by the application
protocolType
a string that identifies the tunneled protocol type
maximum length: MAX_TSM_ALTID_VARS_LENGTH
protocolTypeLength
the length of the protocolType string
protocolVariant
a string that identifies the tunneled protocol variant
maximum length: MAX_TSM_ALTID_VARS_LENGTH
protocolVariantLength
the length of the protocolVariant string
subIdentifier
a string that provides additional tunneled protocol identification
maximum length: MAX_TSM_ALTID_VARS_LENGTH
subIdentifierLength
the length of the subIdentifier string