ThbTapiCall.Dial

The Dial function dials the dialable number, passed in the DestAddr parameter, on an existing call appearance. For example, after a call has been set up for transfer or conference, a consultation call is automatically allocated and the Dial function would be used to perform the dialing of this consultation call.

Example

// setup a transfer for CallA
try
  CallB := CallA.SetupTransfer;
  CallB.Dial('1234');
except
  if CallB <> nil then // Dialing failed, so we drop the call
    CallB.Drop;
end;

Declaration

procedure Dial(DestAddr: String);

Remarks

Using this method causes the TAPI lineDial function to be called. This function works in an asynchronous manner. See the chapter "The Synchronous / Asynchronous Model" and the ThbTapiLine.Options.SyncMode property to read more about the handling of asynchronous functions.

Errors

Using this function may cause an EhbTapiError exception . Possible errors are:

LINEERR_ADDRESSBLOCKED, LINEERR_INVALPOINTER, LINEERR_DIALBILLING, LINEERR_NOMEM, LINEERR_DIALDIALTONE, LINEERR_NOTOWNER, LINEERR_DIALPROMPT, LINEERR_OPERATIONFAILED, LINEERR_DIALQUIET, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_UNINITIALIZED, LINEERR_INVALCOUNTRYCODE.

Declaration

Remarks

Errors

See Also