ThbTapiCall.Handoff
Unit: hbTapi

The method gives ownership of call to another application. The application that is the target of the handoff is specified by its file name passed within the FileName parameter. A valid file name does not include the path of the file.

Example

procedure TForm1.hbTapiLine1MediaMode(Sender: ThbTapiLine; Call: ThbTapiCall);
begin
  if (Call.MediaMode and LINEMEDIAMODE_G3FAX) <> 0 then
  try
    Call.HandOff('faxappl.exe');
  except
    on E:EhbTapiError do
      // handle the error
  end;
end;

Declaration

procedure Handoff(FileName: String);

Remarks

Please refer to the section "lineHandoff" in TAPI's documentation for a more detailed information.

Errors

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

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALMEDIAMODE, LINEERR_TARGETNOTFOUND, LINEERR_INVALPOINTER, LINEERR_TARGETSELF, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_NOTOWNER.