Jump to: navigation, search



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


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.)


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.

This page was last edited on March 17, 2016, at 18:07.
Comments or questions about this documentation? Contact us for support!