Share via


IRTCSessionStateChangeEvent2

The IRTCSessionStateChangeEvent2 interface contains additional properties related to session state change events. These methods extend the functionality provided by the IRTCSessionStateChangeEvent interface.

When the application's implementation of the IRTCEventNotification::Event method indicates an RTC_EVENT of type RTCE_SESSION_STATE_CHANGE, the method's pEvent parameter is an IDispatch pointer for the IRTCSessionStateChangeEvent interface. To retrieve the IRTCSessionStateChangeEvent2 interface, call QueryInterface on the IRTCSessionStateChangeEvent interface, passing the appropriate IID (4F933171-6F95-4880-80D9-2EC8D495D261).

Methods in Vtable Order

The IRTCSessionStateChangeEvent2 interface inherits the methods of the standard COM interface IUnknown.

In addition, IRTCSessionStateChangeEvent2 defines the following methods, including those inherited from IRTCSessionStateChangeEvent.

Method Description
get_MediaTypes Returns the media types that are available on the incoming call. This method should be called only on RTCST_PC_TO_PC sessions in the RTCSS_INCOMING state.
get_RemotePreferredSecurityLevel Returns the security level for the audio/video or T120 media stream encryption.
get_IsForked Returns whether the session has been sent to multiple devices. This method may be called only on a session in the RTCSS_INCOMING state.
GetRemoteSessionDescription Retrieves the session description from the remote client.

Requirements

Redistributable: Requires Rtcdll.dll on Windows 2000, Windows XP, and Windows Server 2003.
Header: Declared in Rtccore.h.
Library: Included as a resource in Rtcdll.dll.
GUID: IID_IRTCSessionStateChangeEvent2 is defined as 4F933171-6F95-4880-80D9-2EC8D495D261.