Dialogic Dialogic Global Call IP IP Phone User Manual


 
277
Dialogic Corporation
The overriding or additional information is contained in other elements in the GC_PARM_BLK.
The elements that can be included are given in Table 38, “Registration Information When Using
H.323”, on page 480 and Table 39, “Registration Information When Using SIP”, on page 482.
Note: For SIP, the Sender’s Address of Record that was used to initially register a binding never changes.
Any attempt to update this value is ignored.
4.22.2.8 Removing Registered Information by Value
Global Call allows applications to delete one or more registration values from an existing
registration. This applies to aliases and supported prefixes in H.323, and to Transport Addresses in
SIP. When an application needs to delete one or more specific values, it uses the gc_ReqService( )
function and passes a GC_PARM_BLK that contain the following parameter element:
IPSET_REG_INFO
IPPARM_OPERATION_REGISTER
value = IP_REG_DELETE_BY_VALUE
Each H.323 alias or SIP Transport Address to be deleted is contained in an additional element in
the GC_PARM_BLK that uses the IPSET_LOCAL_ALIAS set ID and the appropriate parameter
ID for the address type.
H.323
Supported prefixes to be deleted from the registration are specified via GC_PARM_BLK elements
that use the IPSET_SUPPORTED_PREFIXES set ID.
If the string that is contained in the value of the GC_PARM_BLK element matches a registered
alias or supported prefix, it is deleted from the local database and an updated list is sent to the
Gatekeeper.
SIP
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.
If the GC_PARM_BLK does not contain any IPSET_LOCAL_ALIAS elements specifying
Transport Addresses to be deleted, no bindings will be deleted and the function call has the same
result as the query operation described in Section 4.22.2.6, “Querying Registration Information
(SIP)”, on page 275.