The IRTCPresencePropertyEvent interface contains methods for retrieving presence properties after a presence state change operation has been performed, as indicated by a RTCE_PRESENCE_PROPERTY event.
When the application's implementation of the IRTCEventNotification::Event method indicates an RTC_EVENT of type RTCE_PRESENCE_PROPERTY, the method's pEvent parameter is an IDispatch pointer for the IRTCPresencePropertyEvent interface. The methods of this interface can be used to retrieve information concerning the status code and change in the state of the Session.
Note You must call the IRTCClient::put_EventFilter method and set an event filter mask that includes the RTCEF_PRESENCE_PROPERTY event to enable reception of session state events. If you do not call IRTCClient::put_EventFilter, your application will not receive any events.
Methods in Vtable Order
The IRTCPresencePropertyEvent interface inherits the methods of the standard COM interface IUnknown.
In addition, IRTCPresencePropertyEvent defines the following methods.
|get_StatusCode||returns the result code of the operation that has just completed.|
|get_StatusText||Returns the text message corresponding to the result code of the operation that has just completed.|
|get_PresenceProperty||Returns the presence property.|
|get_Value||Returns the value of the presence property.|
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_IRTCPresencePropertyEvent is defined as F777F570-A820-49d5-86BD-E099493F1518.