Share via

SignalingSession.BeginSendReliableProvisionalResponse Method

  • Article

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

Sends a reliable provisional response with option to send answer for early media.

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

Syntax

'Declaration
Public Function BeginSendReliableProvisionalResponse ( _
    responseCode As Integer, _
    signalingHeaders As IEnumerable(Of SignalingHeader), _
    needEarlyMediaSupport As Boolean, _
    userCallback As AsyncCallback, _
    state As Object _
) As IAsyncResult

public IAsyncResult BeginSendReliableProvisionalResponse (
    int responseCode,
    IEnumerable<SignalingHeader> signalingHeaders,
    bool needEarlyMediaSupport,
    AsyncCallback userCallback,
    Object state
)

Parameters

  • responseCode
    The provisonal response code in the range 101-199.
  • signalingHeaders
    The custom signaling headers to add the response.
  • needEarlyMediaSupport
    The flag indicating whether the provisional response needs to send the media description.
  • userCallback
    The callback to be invoked when the SendProvisionalResponse operation has completed.
  • state
    The state to be passed back to the callback.

Return Value

An IAsyncResult object that references this operation.

Exceptions

Exception type Condition
ArgumentOutOfRangeException

Thrown when the response code is not a provisional response code.
InvalidOperationException

Thrown if the sesison is not in incoming state.

Remarks

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.

Thread Safety

All public static (Shared in Visual Basic) members of this type are thread-safe. Instance members are not guaranteed to be thread-safe.

Platforms

Development Platforms

Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Vista Ultimate Edition, Windows Vista Business Edition, Windows Vista Enterprise Edition

Target Platforms

See Also

Reference

SignalingSession Class
SignalingSession Members
Microsoft.Rtc.Signaling Namespace