Dialogic 05-2239-009 User Manual

Page of 604
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 
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