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. |