IRTCParticipantStateChangeEvent
RTCE_PARTICIPANT_STATE_CHANGE events have an IRTCParticipantStateChangeEvent interface. This type of event is fired when a participant changes state.
When the application's implementation of the IRTCEventNotification::Event method indicates an RTC_EVENT of type RTCE_PARTICIPANT_STATE_CHANGE, the method's pEvent parameter is an IDispatch pointer for the IRTCParticipantStateChangeEvent interface.
Note You must call the IRTCClient::put_EventFilter method and set an event filter mask that includes the RTCEF_PARTICIPANT_STATE_CHANGE event to enable reception of participant events. If you do not call IRTCClient::put_EventFilter, your application will not receive any events.
Methods in Vtable Order
The IRTCParticipantStateChangeEvent interface inherits the methods of the standard COM interface IUnknown.
In addition, IRTCParticipantStateChangeEvent defines the following methods.
| Method | Description |
|---|---|
| get_Participant | Returns the Participant object that changed state. |
| get_State | Returns the new state of the Participant. |
| get_StatusCode | Returns a result code associated with the state change. This is typically a SIP or PINT status code. |
Requirements
Client: Requires Windows XP.
Server: Requires Windows Server 2003.
Redistributable: Requires Rtcdll.dll on Windows 2000, and Windows Me/98.
Header: Declared in Rtccore.h.
Library: Included as a resource in Rtcdll.dll.
GUID: IID_IRTCParticipantStateChangeEvent is defined as 09bcb597-f0fa-48f9-b420-468cea7fde04.