TGetAccessNumber

Description

Allows an application to get an access number to reach the destination switch.

Parameters

Name	Description
server	Local server handle to the T-Server in question.
dn	Directory number of the telephony object from which the request is initiated.
conn_id	Connection identifier of the call that is requested to be transferred to the destination switch.
destination	Directory number of the party where the call is requested to be transferred.
location	Name of the remote location in the form of <SwitchName> or <T-ServerApplicationName>@<SwitchName>.
xroute_type	Type of routing. Refer to the type TXRouteType.
user_data	A pointer to call-related user data that should be attached to the call.
reasons	Reserved for future use. For forward compatibility, this parameter must be NULL.
extensions	A pointer to an additional data structure.

Return Values

Standard (See standard-return-values.)

Comments

When a client application sends a TGetAccessNumber request to T-Server, T-Server will return the access number depending on the location parameter value:

• If the location parameter is NULL or identical to the location of the T-Server (T-Server A) receiving this request, T-Server A will process this request and return the access number that will be used by an application to reach the switch that this T-Server A is connected to.
• If the location parameter is the location of another T-Server (T-Server B), T-Server A after receiving this request will pass it to T-Server B. After T-Server A receives the access number from T-Server B, T-Server A will return the access number that will be used by an application to reach the switch that T-Server B is connected to.

The application can cancel the pending request by sending a TCancelReqAccessNumber request.