Call.Forward Method

Definition

Namespace:

Microsoft.Rtc.Collaboration

Assembly:

Microsoft.Rtc.Collaboration.dll

Overloads

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

Forward(String, CallForwardOptions)

Forwards the call to a different target URI with given options.

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

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

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

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

Parameters

targetUri

String

The forward target URI.

forwardOptions

CallForwardOptions

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

Exceptions

ArgumentException

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

Thrown when the forwardOptions parameter contains restricted signaling headers.

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, the call will be forwarded with a 303 response code.

Forward(String)

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

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

protected void Forward (string targetUri);

member this.Forward : string -> unit

Protected 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 valid state to perform this operation.

RealTimeException

Thrown when the forward operation failed to complete successfully.

Remarks

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