AudioVideoCall.Forward Method

Definition

Namespace:

Microsoft.Rtc.Collaboration.AudioVideo

Assembly:

Microsoft.Rtc.Collaboration.dll

Overloads

Forward(String)	Forward the call to the specified target URI with a response code of 303.
Forward(String, CallForwardOptions)	Redirect the audiovideo call to a different target URI.

Forward(String)

Forward the call to the specified target URI with a response code of 303.

public:
 void Forward(System::String ^ targetUri);

public void Forward (string targetUri);

override this.Forward : string -> unit

Public Sub Forward (targetUri As String)

Parameters

targetUri

String

The forward target URI.

Exceptions

ArgumentException

Thrown when the targetUri parameter is null, empty or invalid.

InvalidOperationException

Thrown when the call is not in a valid state to perform this operation.

RealTimeException

Thrown when the forward operation failed to complete successfully.

Remarks

Redirects the audiovideo call to a different target. Forwarding is carried out by a proxy when supported.

Forward(String, CallForwardOptions)

Redirect the audiovideo call to a different target URI.

public:
 void Forward(System::String ^ targetUri, Microsoft::Rtc::Collaboration::CallForwardOptions ^ forwardOptions);

public void Forward (string targetUri, Microsoft.Rtc.Collaboration.CallForwardOptions forwardOptions);

override this.Forward : string * Microsoft.Rtc.Collaboration.CallForwardOptions -> unit

Public Sub Forward (targetUri As String, forwardOptions As CallForwardOptions)

Parameters

targetUri

String

The forward target URI.

forwardOptions

CallForwardOptions

Optional parameters to forward the audiovideo call. This includes using a specific response code for forwarding the audiovideo call.

Exceptions

ArgumentException

Thrown when the targetUri parameter is null, empty or invalid.

InvalidOperationException

Thrown when the call is not in valid state to perform this operation.

RealTimeException

Thrown when the forward operation failed to complete successfully.

Remarks

When the forwardOptions parameter is null, this call will be forwarded with a response code of 303. Redirects the audiovideo call to a different target. Depending on the response code, the forward is either carried out by the proxy when supported or by the user agent client that sent the invite request.