Filter
Top Products
550 Dialogic
®
Global Call API Library Reference — November 2007
Dialogic Corporation
IP_REGISTER_ADDRESS — gatekeeper registration information
IP_REGISTER_ADDRESS
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.