IRTCSessionStateChangeEvent3::ReplacedSession (Windows Embedded CE 6.0)

1/6/2010

Applies to Windows Embedded CE 6.0 R2

This method returns the session that can be replaced.

When an INVITE with a replaces header is received, the RTC stack looks for the matched session. If the matched session is found, the RTC stack creates a new session. When the new session fires a session state change event at incoming state, the application can query this interface and check if there is a session to be replaced. If the application chooses to accept the new session, it should terminate ppReplacedSession after the new session is established.

Syntax

HRESULT ReplacedSession(
    IRTCSession** ppReplacedSession
);

Parameters

• ppReplacedSession
  [out] Pointer to IRTCSession interface of the session to replace. This method adds a reference to the Session object which the caller is responsible for releasing.

Return Value

This method returns a S_OK when it completes successfully.

This method can return an RTC_E_ constant.

Requirements

See Also

Reference

IRTCSessionStateChangeEvent3
IRTCSessionCallControl2
IRTCSessionConsultantReferredEvent