Allows an application to get an access number to reach the destination switch.
|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.|
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.