McuSession.BeginDialOut Method

Sends a request to MCU to initiate a call to the supplied destination URI.

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

Syntax

'Declaration
Protected Function BeginDialOut ( _
    destinationUri As String, _
    mcuDialOutOptions As McuDialOutOptions, _
    userCallback As AsyncCallback, _
    state As Object _
) As IAsyncResult
'Usage
Dim destinationUri As String
Dim mcuDialOutOptions As McuDialOutOptions
Dim userCallback As AsyncCallback
Dim state As Object
Dim returnValue As IAsyncResult

returnValue = Me.BeginDialOut(destinationUri, _
    mcuDialOutOptions, userCallback, _
    state)
protected IAsyncResult BeginDialOut(
    string destinationUri,
    McuDialOutOptions mcuDialOutOptions,
    AsyncCallback userCallback,
    Object state
)

Parameters

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

RealTimeInvalidOperationException

Thrown when the parent ConferenceSession is reconnecting (FailureReason will be set to InvalidOperationReason.RetryableOperation).

Remarks

The appearance of the dialed-out to endpoint in the conference roster can be customized by supplying a participant URI and display name in the mcuDialOutOptions object. The MCU may not honor the settings if the asserted identity of the dialed-out to endpoint was communicated to the MCU during the dial-out operation.

See Also

Reference

McuSession Class

McuSession Members

Microsoft.Rtc.Collaboration Namespace