Dialogic Dialogic Global Call IP IP Phone User Manual


 
276
Dialogic Corporation
The application specifies the Registrar and Alias to query by including the following parameter
element in the GC_PARM_BLK that is passed to gc_ReqService( ):
IPSET_REG_INFO
IPPARM_REG_ADDRESS
value = IP_REGISTER_ADDRESS structure with reg_client and reg_server fields filled
in to indicate the desired Registrar address and Alias to query
Note: This parameter is optional. If it is not included in the GC_PARM_BLK, or if either of the addresses
in the IP_REGISTER_ADDRESS structure is not supplied, the most recently used Registrar
address and Alias are used by default.
By default, the registration query operation returns all Transport Addresses that are currently
registered for the specified Alias by the application. If the application wishes to query all Transport
Addresses that have been registered in the Registrar for the specified Alias (that is, all registrations
by all applications), the GC_PARM_BLK that it supplies to the gc_ReqService( ) function must
include the following element:
IPSET_LOCAL_ALIAS
IPPARM_ADDRESS_TRANSPARENT
value = "*"
The GCEV_SERVICERESP completion event for this function call contains all current bindings
for the specified Address of Record in a series of IPSET_LOCAL_ALIAS /
IPPARM_ADDRESS_TRANSPARENT parameter elements. The value of each of these elements
is a null-terminated string that contains a current binding created by this application along with any
header field parameters that were appended by the Registrar.
4.22.2.7 Changing Registration Information
The Dialogic
®
Global Call API provides the ability to modify or add to the registration information
after it has been registered with the Gatekeeper/Registrar. To change registration information, the
application uses the gc_ReqService( ) function and passes a GC_PARM_BLK that contains the
following element:
IPSET_REG_INFO
IPPARM_OPERATION_REGISTER
and one of the following values:
IP_REG_SET_INFO – override existing registration
IP_REG_ADD_INFO – add to existing registration information
A SIP application can specify the Registrar and Alias to modify information for by including the
following parameter in the GC_PARM_BLK that is passed to gc_ReqService( ):
IPSET_REG_INFO
IPPARM_REG_ADDRESS
value = IP_REGISTER_ADDRESS structure with reg_client and reg_server fields filled
in to indicate the desired Registrar address and Alias
Note: This parameter is optional. If it is not included in the GC_PARM_BLOCK, or if either of the
addresses in the IP_REGISTER_ADDRESS structure is not supplied, the most recently used
Registrar address and Alias are used by default.