AudioVideoCall.BeginEstablish Method (AudioVideoCallEstablishOptions, AsyncCallback, Object)
Establishes an outgoing call using audio-video call specific options.
Namespace: Microsoft.Rtc.Collaboration.AudioVideo
Assembly: Microsoft.Rtc.Collaboration (in Microsoft.Rtc.Collaboration.dll)
Syntax
'Declaration
Public Function BeginEstablish ( _
options As AudioVideoCallEstablishOptions, _
userCallback As AsyncCallback, _
state As Object _
) As IAsyncResult
'Usage
Dim instance As AudioVideoCall
Dim options As AudioVideoCallEstablishOptions
Dim userCallback As AsyncCallback
Dim state As Object
Dim returnValue As IAsyncResult
returnValue = instance.BeginEstablish(options, _
userCallback, state)
public IAsyncResult BeginEstablish(
AudioVideoCallEstablishOptions options,
AsyncCallback userCallback,
Object state
)
Parameters
- options
Type: Microsoft.Rtc.Collaboration.AudioVideo.AudioVideoCallEstablishOptions
Optional parameters to establish the 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 call is not in valid state to perform this operation or does not have valid media provider to bind to or |
Remarks
Applications can use AudioVideoMcuDialInOptions property to set MCU dial-in options if this call established with a MCU.
Setting the UseGeneratedIdentityForTrustedConference property to true is only valid in scenarios where the conversation has joined a conference as a trusted application. See ConferenceJoinOptions.
An application can establish multiple AudioVideoCall instances within the same conversation if that conversation joined the conference as a trusted application. In order to establish multiple calls, the application needs to set UseGeneratedIdentityForTrustedConference to true.