IRTCSessionStateChangeEvent2:IRTCSessionStateChangeEvent
This interface retrieves additional information related to session state change events. It extends the IRTCSessionStateChangeEvent interface for content streaming sessions.
Methods
The following tables show the methods for this interface in vtable order. This is the order in which the compiler calls the methods. This interface inherits the methods for the IUnknown and IRTCSessionStateChangeEvent interfaces.
The following table shows the IRTCSessionStateChangeEvent methods.
| Method | Description |
|---|---|
| Session | Gets the Session object that changed state. |
| State | Gets the state of the session. |
| StatusCode | Gets the result code associated with the state change. |
| StatusText | Gets the status text associated with the status code. |
The following table shows the IRTCSessionStateChangeEvent2 methods.
| Method | Description |
|---|---|
| MediaTypes | Gets the media types that are available on the incoming call. |
| RemotePreferredSecurityLevel | Gets the security level for the audio, video, or T120 media stream encryption. |
| IsForked | Determines if the session has been sent to multiple devices. |
| GetRemoteSessionDescription | Retrieves the session description from the remote client. |
Obtaining a Pointer
When the application's implementation of the IRTCEventNotification::Event method indicates an RTC_EVENT enumeration value of RTCE_SESSION_STATE_CHANGE, the method's pEvent parameter is an IDispatch pointer for the IRTCSessionStateChangeEvent interface.
To retrieve this interface, the application should call QueryInterface on IRTCSessionChangeEvent interface, passing the appropriate IID (4F933171-6F95-4880-80D9-2EC8D495D261).
Remarks
To enable reception of session state change events, the application must call the IRTCClient::EventFilter method and set an event filter mask that includes the RTCE_SESSION_STATE_CHANGE event. If the application does not call IRTCClient::EventFilter, it will not receive any events.
Requirements
OS Versions: Windows CE .NET 4.2 and later.
Header: Rtccore.h, Rtccore.idl.
Link Library: Uuid.lib.
See Also
IDispatch | IDispatch::Invoke | IRTCClient::EventFilter | IRTCEventNotification::Event | IRTCSessionStateChangeEvent | IUnknown | RTC_EVENT | QueryInterface
Last updated on Saturday, April 10, 2004
© 1992-2003 Microsoft Corporation. All rights reserved.