Dialogic Dialogic Global Call IP IP Phone User Manual


 
275
Dialogic Corporation
IP_AUTOREFRESH_ENABLE – enable auto-refresh for a specific registration, using the
non-zero value specified in IP_REGISTER_ADDRESS.time_to_live or the default value
of 3600 in the Expires header field
Note: If this parameter is not present in the GC_PARM_BLK when registration is
requested, auto-refresh is enabled by default.
4.22.2.5 Receiving Notification of Registration
An application that sends a registration request to a Gatekeeper/Registrar receive notification of
whether the registration is successful or not. When using the Dialogic
®
Global Call API, the
application receives a GCEV_SERVICERESP termination event with an associated
GC_PARM_BLK that contains the following elements:
IPSET_PROTOCOL
IPPARM_PROTOCOL_BITMASK
with one of the following values:
IP_PROTOCOL_H323
IP_PROTOCOL_SIP
IPSET_REG_INFO
IPPARM_REG_STATUS
with one of the following values:
IP_REG_CONFIRMED – registration operation completed properly
IP_REG_REJECTED – registration operation did not complete properly; the
gc_ResultInfo( ) function can be used to retrieve the reason for the failure
SIP
For registrations with a SIP Registrar, the GC_PARM_BLK associated with the
GCEV_SERVICERESP termination event also contains the following element:
IPSET_REG_INFO
IPPARM_REG_SERVICEID
value = the Service ID that was handed back to the application when the initiating
gc_ReqService( ) was made
This Service ID can be used by the application to distinguish among multiple events returned on a
given handle, since the application can send multiple simultaneous REGISTER requests to
different Registrars or to the same Registrar on behalf of different User Agents.
4.22.2.6 Querying Registration Information (SIP)
Global Call provides a mechanism for a SIP application to query a Registrar to determine what
bindings currently exist. To do this, the application calls gc_ReqService( ) with the following
parameter element included in the GC_PARM_BLK that is passed to the function:
IPSET_REG_INFO
IPPARM_OPERATION_REGISTER
value = IP_REG_QUERY_INFO