Call Completion

When making an outbound call, the unavailability of certain resources can prevent the call from reaching the connected state, as when the destination party is busy or doesn't answer. Unavailable resources include trunk circuits as well as the destination party's station. The lineCompleteCall function lets the application specify how it wants to complete a call that cannot be completed normallypics/TAPI00090000.gifthis is called "placing a call-completion request." The application has the following options:

  • Camp on to queue the call until the call can be completed.

  • Call back requests the called station to return the call when the station returns to idle. Answering the call-back can automatically reinitiate (redial) the connection request.

  • Intrude allows the application to barge in to the existing call.

  • Message (also known as "leave word calling") allows the application to send one of a small number of predefined messages to the destination. These messages can be text shown on the phone's display, a voice message left for the user, and so forth.

A call completion request can be canceled with lineUncompleteCall. Multiple call completion requests can potentially be outstanding for a given address at any one time. To identify individual requests, the implementation returns a completion ID. When a call completion request completes and results in a new call, the call completion ID is available in the LINECALLINFO data structure returned by lineGetCallInfo. Canceling a call completion request in progress also uses this call completion ID.

In versions 0x0002000 and greater, the LINECALLREASON_CAMPEDON bit allows a service provider to indicate when a new call was camped on to an address.

Software for developers
Delphi Components
.Net Components
Software for Android Developers
More information resources
Unix Manual Pages
Delphi Examples
Databases for Amazon shops developers
Amazon Categories Database
Browse Nodes Database