Provider
Synchronous
No Custom Parameters
Does a transfer between calls that exist on the same/different lines on a particular device. After a direct transfer, the common party(parties) on the device get dropped.
JTapiDirectTransfer will transfer the parties from the SecondCall to the FirstCall.On completion of a JTapiDirectTransfer JTapiCallActive will get delivered to the other parties which were involved in FirstCall and SecondCall.
The CallControlCause will be set to TRANSFER for the event. The associated party on the SecondCall will get a new CallID because of the transfer.
Events due to a Direct Transfer on Same Line :
Assume the following scenario
1. Line A on Device T1.
2. Line B1 on Device T2.
3. Line C on Device T3.
Now A calls B1 and gets call id 1111. B1 gets CallID 2222.
B1 calls C and gets call id 3333 while C gets call id 4444.
Now invoke JtapiDirectTransfer(2222,3333) on T2. This will result in a call between A and C.B1 will get dropped from both the calls.
A will receive JTapiCallActive with CallControlCause set to TRANSFER. Call ID 1111 will remain.
C will receive JTapiHangup for 4444 with CallControlCause set to TRANSFER. This will be followed by JTapiCallActive with CallControlCause set to TRANSFER and a new call ID 5555.
Events due to a Direct Transfer Across Lines :
Assume the following scenario:
1. Line A on Device T1.
2. Lines B1 and B2 on Device T2.
3. Line C on Device T3.
Now A calls B1 and gets call id 1111. B1 gets CallID 2222.
B2 calls C and gets call id 3333 while C gets call id 4444.
Now invoke JtapiDirectTransfer(2222,3333) on T2 This will result in a call between A and C.B1 and B2 will get dropped from both the calls.
A will receive JTapiCallActive with CallControlCause set to TRANSFER. Call ID 1111 will remain.
C will receive JTapiHangup for 4444 with CallControlCause set to TRANSFER. This will be followed by JTapiCallActive with CallControlCause set to TRANSFER and a new call ID 5555.
| Parameter Name | .NET Type | Default | Description |
|---|---|---|---|
| Timeout | System.Int32 | The Timeout property specifies to the Application Runtime Environment how long
to wait for a response from the provider for the current action.
The ReturnValue returned in this case is Timeout. The value must be a literal value in milliseconds. | |
| FirstCallId * | System.Int64 | One of the two calls that have been established on the same line.This call leg for this callID will get dropped during transfer. | |
| SecondCallId * | System.Int64 | The second of the two calls that have been established on the same line or on the 2nd line on the same device.This call leg for this callID will get dropped during transfer. |
No Result Data
Branch Conditions
No description.
No description.
No description.