Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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.