BeginTransfer Method (String, CallTransferOptions, AsyncCallback, Object)
Initiates a transfer request to the remote participant to transfer the current call to the given transfer target in either Attended or Unattended mode.
Namespace: Microsoft.Rtc.Collaboration.AudioVideo
Assembly: Microsoft.Rtc.Collaboration (in Microsoft.Rtc.Collaboration.dll)
Syntax
'Declaration
Public Function BeginTransfer ( _
targetUri As String, _
callTransferOptions As CallTransferOptions, _
userCallback As AsyncCallback, _
state As Object _
) As IAsyncResult
'Usage
Dim instance As AudioVideoCall
Dim targetUri As String
Dim callTransferOptions As CallTransferOptions
Dim userCallback As AsyncCallback
Dim state As Object
Dim returnValue As IAsyncResult
returnValue = instance.BeginTransfer(targetUri, _
callTransferOptions, userCallback, _
state)
public IAsyncResult BeginTransfer(
string targetUri,
CallTransferOptions callTransferOptions,
AsyncCallback userCallback,
Object state
)
Parameters
- targetUri
Type: System..::..String
- callTransferOptions
Type: Microsoft.Rtc.Collaboration..::..CallTransferOptions
- userCallback
Type: System..::..AsyncCallback
- state
Type: System..::..Object
Return Value
Type: System..::..IAsyncResult
Remarks
In the Unattended type, the call is terminated as soon as the transfer request is accepted by the remote participant. In the Attended type, the call monitors the success or failure notifications from the remote regarding how the transfer is being carried out. If the transfer succeeds, this call is terminated, otherwise the call is not affected.
Exceptions
[T:System.ArgumentNullException]: Thrown if the value is null.
[T:System.ArgumentException]: Thrown if the parameter is specified with unsupported headers or if it is used to override transferor value by any endpoint other than an Application Endpoint.
[T:System.InvalidOperationException]: Thrown if the current call is not in a valid state to initiate a transfer operation.