Dialogic IP Phone 05-2239-009 User Manual

550

Dialogic Corporation

gatekeeper registration information

typedef struct
{
    char              reg_client [IP_REG_CLIENT_ADDR_LENGTH];
    char              reg_server [IP_REG_SERVER_ADDR_LENGTH];
    int               time_to_live;
    int               max_hops;
} IP_REGISTER_ADDRESS;

„ Description

The IP_REGISTER_ADDRESS data structure is used to store registration information.

„ Field Descriptions

The fields of the IP_REGISTER_ADDRESS data structure are described as follows:

reg_client 

The meaning is protocol dependent:

When using H.323, this field is not used; any value specified is ignored 

When using SIP, this field is an alias for the subscriber

reg_server 

The address of the registration server. Possible value are: 

An IP address in dot notation. A port number can also be specified as part of the address, 
for example, 10.242.212.216:1718.

IP_REG_MULTICAST_DEFAULT_ADDR

time_to_live 

The time to live value in seconds. The number of seconds for which a registration is considered 
to be valid when repetitive registration is selected.

In H.323, the default value of this field is 0, which disables repetitive registration.

In SIP, if this field is left at its default value 0, the call control library automatically enables 
auto-refresh with an Expires value of 3600 unless the application explicitly disables auto-
refresh. Setting this to a non-zero value sets the Expires header in the REGISTER request to 
the specified value.

max_hops 

The multicast time to live value in hops. The maximum number of hops (connections between 
routers) that a packet can take before being discarded or returned when using multicasting.

This field applies only to H.323 applications using gatekeeper discovery (H.225 RAS) via the 
default multicast registration address.