TAPI.Transfer
-------------

Transfers the current call to the destination address.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [TAPI](component_TAPI.md) | [5.0](newinversion50.md) | ❌ No | ✅ Yes | ❌ No | ❌ No | ❌ No |

MBS( "TAPI.Transfer"; Call; OtherCall; Sync ) 

**MBS**( **"TAPI.Transfer";** /\* Transfers the current call to the destination address. \*/  
**$Call**; /\* The call reference number. \*/   
**$OtherCall**; /\* The other call reference number. This is the consultation call created for the transfer.e.g. $Call2 \*/   
**$Sync**) /\* Indicates whether the method should be completed synchronously (1) or asynchronously (0).e.g. 1 \*/ 

### Parameters

| Parameter | Description | Example |
|---|---|---|
| Call | The call reference number. | $Call |
| OtherCall | The other call reference number. This is the consultation call created for the transfer. | $Call2 |
| Sync | Indicates whether the method should be completed synchronously (1) or asynchronously (0). | 1 |

### Result

Returns OK or error.

### Description

Transfers the current call to the destination address.  
  
Call transfer involves setting up a consultation call in preparation for the transfer. Call2 is the identifier returned [TAPI.CreateCall](TAPICreateCall.md) following the creation of a consultation call. [TAPI.Finish](TAPIFinish.md) (with AsTransfer) completes the transfer.  
  
If the consultation call is not in the Connected state when Transfer is called, TAPI will use the destination address (as specified when the consultation call was first created via [TAPI.CreateCall](TAPICreateCall.md) and try to connect at that time. If the original call had an empty destination address, Transfer will fail with error (invalid argument).  
### See also

- [TAPI.CreateCall](TAPICreateCall.md)
- [TAPI.Finish](TAPIFinish.md)

### Blog Entries

- [MBS Filemaker Plugin, version 4.5pr3](https://www.mbsplugins.de/archive/2014-12-06/MBS_Filemaker_Plugin_version_4/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 3th December 2014 , last changed 3th December 2014

  
[TAPI.Shutdown](TAPIShutdown.md) - [TAPI.Unpark](TAPIUnpark.md)

[HTML Version](TAPITransfer.shtml)