IRTCSessionCallControl2::ReplaceSession (Windows Embedded CE 6.0)

1/6/2010

This method transfers the remote User Agent of the current session to the remote User Agent of pReplacedSession, and terminates the current session and pReplacedSession. The party initiating the transfer is a User Agent on both sessions. Both sessions must be in the hold or connected state.

This method sends a REFER with a replace in the refer-to header. If the remote User Agent does not support Replaces header, the REFER will be rejected.

Syntax

HRESULT ReplaceSession (
    BSTR IRTCSession* pReplacedSession
);

Parameters

• pReplacedSession
  [in] The session that will be terminated and replaced.

Return Value

This method returns a S_OK when it completes successfully.

This method can return an RTC_E_ constant.

Requirements

See Also

Reference

IRTCSessionCallControl2
IRTCSessionConsultantReferredEvent
IRTCSessionStateChangeEvent3

Other Resources