Renegotiates the media description. Only one negotiation can be outstanding at any time. The session should be in the Connected state for this method to work.

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

Syntax

Visual Basic (Declaration) 
Public 
Function 
BeginRenegotiateDescription ( _
	
userCallback 
As 
AsyncCallback, _
	
state 
As 
Object _
) 
As 
IAsyncResult
C# 
public 
IAsyncResult 
BeginRenegotiateDescription(
	
AsyncCallback 
userCallback,
	
Object 
state
)
Visual C++ 
public:
IAsyncResult^ 
BeginRenegotiateDescription(
	
AsyncCallback^ 
userCallback, 
	
Object^ 
state
)
JavaScript 
function 
beginRenegotiateDescription(
userCallback, 
state);

Parameters

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.

Remarks

In an early dialog, BeginRenegotiateDescription is intended to send only SDP-bearing messages. As such, this method does not differentiate between a call to BeginRenegotiateDescription with a provided SDP session description and a call without an SDP session description. Both will conflict with incoming SDP-bearing UPDATE messages.

Exceptions

Exception Condition
InvalidOperationException Thrown when the session is not in a valid state to renegotiate.
Microsoft.Rtc.Signaling . . :: . RealTimeInvalidOperationException Thrown when called in a temporary invalid state, and the operation can be retried.
Microsoft.Rtc.Signaling . . :: . RealTimeException Thrown when there is no media description available.
Exception Thrown by the application when generating media (interface IOfferAnswer) is not handled by the platform.

See Also