Dialogic Dialogic Global Call IP IP Phone User Manual


 
552 Dialogic
®
Global Call API Library Reference — November 2007
Dialogic Corporation
IP_TUNNELPROTOCOL_OBJECTID — tunneled signaling protocol object ID
IP_TUNNELPROTOCOL_OBJECTID
tunneled signaling protocol object ID
typedef struct
{
unsigned long version;
char TunneledProtocol_Oid[MAX_TSM_OBJID_VARS_LENGTH];
int TunneledProtocol_OidLength;
char subIdentifier[MAX_TSM_OBJID_VARS_LENGTH];
int subIdentifierLength;
} IP_TUNNELPROTOCOL_OBJECTID;
Description
The IP_TUNNELPROTOCOL_OBJECTID data structure is used in H.323 Annex M tunneled
signaling to identify the tunneling protocol using a protocol object ID. This data structure is used as
the value of a Global Call parameter element of type IPSET_TUNNELEDSIGNALMSG /
IPPARM_TUNNELEDSIGNALMSG_PROTOCOL_OBJECTID. This data structure is not used
when the tunneled signaling message uses the alternate ID method to identify the protocol.
Applications should use the INIT_IP_TUNNELPROTOCOL_OBJECTID( ) function to
initialize the structure with the correct version number and initial field values.
Field Descriptions
The fields of the IP_TUNNELPROTOCOL_OBJECTID data structure are described as follows:
version
the version number of the data structure; the correct value is set by the
INIT_IP_TUNNELPROTOCOL_OBJECTID( ) initialization function and should not be
overridden by applications
TunneledProtocol_Oid
a string that identifies the tunneled protocol object
maximum length: MAX_TSM_OBJECTID_VARS_LENGTH
TunneledProtocol_OidLength
the actual length of the TunneledProtocol_Oid string
subIdentifier
a string that provides additional tunneled protocol identification
maximum length: MAX_TSM_OBJECTID_VARS_LENGTH
subIdentifierLength
the actual length of the subIdentifier string