Initiates a transfer request to the remote participant.

Namespace:  Microsoft.Rtc.Collaboration.AudioVideo
Assembly:  Microsoft.Rtc.Collaboration(in Microsoft.Rtc.Collaboration.dll)

Syntax

Visual Basic (Declaration) 
Public 
Function 
BeginTransfer ( _
	
targetUri 
As 
String, _
	
userCallback 
As 
AsyncCallback, _
	
state 
As 
Object _
) 
As 
IAsyncResult
C# 
public 
IAsyncResult 
BeginTransfer(
	
string 
targetUri,
	
AsyncCallback 
userCallback,
	
Object 
state
)
Visual C++ 
public:
IAsyncResult^ 
BeginTransfer(
	
String^ 
targetUri, 
	
AsyncCallback^ 
userCallback, 
	
Object^ 
state
)
JavaScript 
function 
beginTransfer(
targetUri, 
userCallback, 
state);

Parameters

targetUri
Type: String
The transfer target URI.
userCallback
Type: AsyncCallback
The method to be called when the asynchronous operation is completed.
state
Type: Object
A user-provided object that distinguishes this particular asynchronous operation from other asynchronous operations.

Return Value

An IAsyncResult that references the asynchronous operation.

Remarks

Transfer the current call to the given transfer target in Attended or Unattended mode.

In the Unattended type, the call is terminated as soon as the transfer request is accepted by the remote participant. In Attended type, the call montiors the success/failure notifications from the remote regarding how the transfer is being carried out. If the transfer succeeds, this call is terminated else, the call is not affected.

Exceptions

Exception Condition
ArgumentNullException Thrown when the targetUri>parameter value is null.
InvalidOperationException Thrown when the current call is not in a valid state to initiate a transfer operation.

See Also