This method can be used to send a reliable provisional response with option to send answer for early media. If the inviter supports 100rel and the local policy is not unsupported, this method will wait for the PRACK. Otherwise, this method will not require 100rel. Any application that supports 100rel is recommended to use this method for sending provisional response. SendProvisional method can be used only when the application knows for sure that the remote does not require 100rel.

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

Syntax

Visual Basic (Declaration) 
Public 
Function 

BeginSendReliableProvisionalResponse ( _
	
responseCode 
As 
Integer, _
	
responseText 
As 
String, _
	
signalingHeaders 
As 
IEnumerable(
Of 

SignalingHeader), _
	
needEarlyMediaSupport 
As 
Boolean, _
	
userCallback 
As 
AsyncCallback, _
	
state 
As 
Object _
) 
As 
IAsyncResult
C# 
public 
IAsyncResult 

BeginSendReliableProvisionalResponse(
	
int 
responseCode,
	
string 
responseText,
	
IEnumerable<

SignalingHeader> 
signalingHeaders,
	
bool 
needEarlyMediaSupport,
	
AsyncCallback 
userCallback,
	
Object 
state
)
Visual C++ 
public:
IAsyncResult^ 

BeginSendReliableProvisionalResponse(
	
int 
responseCode, 
	
String^ 
responseText, 
	
IEnumerable<

SignalingHeader^>^ 
signalingHeaders, 
	
bool 
needEarlyMediaSupport, 
	
AsyncCallback^ 
userCallback, 
	
Object^ 
state
)
JavaScript 
function 

beginSendReliableProvisionalResponse(
responseCode, 
responseText, 
signalingHeaders, 
needEarlyMediaSupport, 
userCallback, 
state);

Parameters

responseCode
Type: Int32
The provisonal response code in the range 101-199.
responseText
Type: String
Reasonphrase send out with the response. If null or empty default reasonphrase will be generated.
signalingHeaders
Type: IEnumerable < (Of < ( SignalingHeader > ) > )
The custom signaling headers to add the response.
needEarlyMediaSupport
Type: Boolean
The flag indicating whether the provisional response need to send media description.
userCallback
Type: AsyncCallback
The method to be called when the asynchronous operation is completed.
state
Type: Object
A user-provided object that distinguishes this particular asynchronous operation from other asynchronous operations.

Return Value

An IAsyncResult that references the asynchronous operation.

Exceptions

Exception Condition
ArgumentOutOfRangeException Thrown when the response code is not a provisional response code.
InvalidOperationException Thrown if the sesison is not in incoming state.

See Also