Jump to: navigation, search

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.

Feedback

Comment on this article:

blog comments powered by Disqus
This page was last modified on June 27, 2017, at 12:21.