AudioVideoCall.BeginTransfer Method (String, AsyncCallback, Object)
Initiates an attended transfer request to the remote participant.
Namespace: Microsoft.Rtc.Collaboration.AudioVideo
Assembly: Microsoft.Rtc.Collaboration (in Microsoft.Rtc.Collaboration.dll)
Syntax
'Declaration
Public Function BeginTransfer ( _
targetUri As String, _
userCallback As AsyncCallback, _
state As Object _
) As IAsyncResult
'Usage
Dim instance As AudioVideoCall
Dim targetUri As String
Dim userCallback As AsyncCallback
Dim state As Object
Dim returnValue As IAsyncResult
returnValue = instance.BeginTransfer(targetUri, _
userCallback, state)
public IAsyncResult BeginTransfer(
string targetUri,
AsyncCallback userCallback,
Object state
)
Parameters
- targetUri
Type: System.String
The transfer target URI.
- userCallback
Type: System.AsyncCallback
The method to be called when the asynchronous operation is completed.
- state
Type: System.Object
A user-provided object that distinguishes this particular asynchronous operation from other asynchronous operations.
Return Value
Type: System.IAsyncResult
An IAsyncResult that references the asynchronous operation.
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. |
Remarks
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.