Requests the Audio-Video MCU to initiate an Audio-Video call to the supplied destination URI.

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

Syntax

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

Parameters

destinationUri
Type: String
The URI of the entity to call.
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

The Audio-Video MCU is requested to initiate a call to the destination URI using audio and video as default media types if the Conversation does not have either audio and video among its active media types. On the other hand, if the Conversation has only audio or video among active its media types, the dial-out request is sent with either audio or video only.

Exceptions

Exception Condition
InvalidOperationException Thrown when the parent ConferenceSession is not in a valid state or the conference does not support the corresponding MCU type.
ArgumentNullException Thrown when the supplied destinationUri is null.
ArgumentException Thrown when the supplied destinationUri is invalid.
Microsoft.Rtc.Signaling . . :: . RealTimeInvalidOperationException Thrown when the parent ConferenceSession is reconnecting (FailureReason will be set to InvalidOperationReason.RetryableOperation).

See Also