Redirect the call to a different target URI. This is similar to Forward except that the forwarding is carried out by a proxy, when supported.

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

Syntax

Visual Basic (Declaration)
Protected 
Sub 
Forward ( _
	
targetUri 
As 
String, _
	
forwardOptions 
As 

CallForwardOptions _
)
C#
protected 
void 
Forward(
	
string 
targetUri,
	

CallForwardOptions 
forwardOptions
)
Visual C++
protected:
void 
Forward(
	
String^ 
targetUri, 
	

CallForwardOptions^ 
forwardOptions
)
JavaScript
function 
forward(
targetUri, 
forwardOptions);

Parameters

targetUri
Type: String
The forward target URI.
forwardOptions
Type: Microsoft.Rtc.Collaboration . . :: . CallForwardOptions
Optional parameters used to forward the call. This includes using a specific response code for forwarding the call.

Remarks

When the forwardOptionsparameter is null, the call will be forwarded with a 303 response code.

Exceptions

Exception Condition
ArgumentException

Thrown when the targetUriparameter is null, empty or invalid.

Thrown when the forwardOptionsparameter contains restricted signaling headers.

InvalidOperationException Thrown when the call is not in valid state to perform this operation.
Microsoft.Rtc.Signaling . . :: . RealTimeException Thrown when the forward operation failed to complete successfully.

See Also