SignalingSession.Refer Method

Definition

Overloads

Refer(RealTimeAddress, ReferStatus)

Synchronously transfers the current session to a different real-time address. This method will wait until the transfer is completed. It is not recommended for a UI thread.

Refer(RealTimeAddress, ReferStatus, IEnumerable<SignalingHeader>)

Synchronously transfers the current session to a different real-time address. This method will wait until the transfer is completed. It is not recommended for a UI thread.

Refer(RealTimeAddress, ReferStatus)

Synchronously transfers the current session to a different real-time address. This method will wait until the transfer is completed. It is not recommended for a UI thread.

public:
 Microsoft::Rtc::Signaling::SipResponseData ^ Refer(Microsoft::Rtc::Signaling::RealTimeAddress ^ referTarget, Microsoft::Rtc::Signaling::ReferStatus ^ referStatus);
public Microsoft.Rtc.Signaling.SipResponseData Refer (Microsoft.Rtc.Signaling.RealTimeAddress referTarget, Microsoft.Rtc.Signaling.ReferStatus referStatus);
member this.Refer : Microsoft.Rtc.Signaling.RealTimeAddress * Microsoft.Rtc.Signaling.ReferStatus -> Microsoft.Rtc.Signaling.SipResponseData

Parameters

referTarget
RealTimeAddress

The session target object containing the Refer URI.

referStatus
ReferStatus

The ReferStatus object that is used to signal Refer state changes.

Returns

SipResponseData

The response data received for the refer request.

Exceptions

Thrown when the session is in an invalid state to send a Refer request.

Thrown when invalid arguments are passed.

Thrown when arguments are null.

Thrown when the server or remote participant returns an error. The response code in the exception should give more information.

Applies to

Refer(RealTimeAddress, ReferStatus, IEnumerable<SignalingHeader>)

Synchronously transfers the current session to a different real-time address. This method will wait until the transfer is completed. It is not recommended for a UI thread.

public:
 Microsoft::Rtc::Signaling::SipResponseData ^ Refer(Microsoft::Rtc::Signaling::RealTimeAddress ^ referTarget, Microsoft::Rtc::Signaling::ReferStatus ^ referStatus, System::Collections::Generic::IEnumerable<Microsoft::Rtc::Signaling::SignalingHeader ^> ^ signalingHeaders);
public Microsoft.Rtc.Signaling.SipResponseData Refer (Microsoft.Rtc.Signaling.RealTimeAddress referTarget, Microsoft.Rtc.Signaling.ReferStatus referStatus, System.Collections.Generic.IEnumerable<Microsoft.Rtc.Signaling.SignalingHeader> signalingHeaders);
member this.Refer : Microsoft.Rtc.Signaling.RealTimeAddress * Microsoft.Rtc.Signaling.ReferStatus * seq<Microsoft.Rtc.Signaling.SignalingHeader> -> Microsoft.Rtc.Signaling.SipResponseData

Parameters

referTarget
RealTimeAddress

The session target object containing the address of the Refer target.

referStatus
ReferStatus

The Refer status object that is used to signal Refer state changes.

signalingHeaders
IEnumerable<SignalingHeader>

Headers required for this Refer.

Returns

SipResponseData

The response data received for the refer request. Can be null.

Exceptions

Thrown when this method is invoked multiple times using the same result.

Thrown when the referTarget or referStatus parameters are null.

Thrown when the referTarget parameter is invalid.

Thrown when this operation timed out.

Thrown when any of the sub operations of this operation failed due to SIP related errors like connection failure, Authentication failure.

Applies to