IRTCMessagingEvent

RTCE_MESSAGING events have an IRTCMessagingEvent interface. This type of event is fired when an incoming instant message arrives, or when an update of the remote user's keystroke status is received.

When the application's implementation of the IRTCEventNotification::Event method indicates an RTC_EVENT of type RTCE_MESSAGING, the method's pEvent parameter is an IDispatch pointer for the IRTCMessagingEvent interface.

Methods in Vtable Order

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

In addition, IRTCMessagingEvent defines the following methods.

Method	Description
get_Session	Returns the Session object associated with the messaging event.
get_Participant	Returns the Participant object associated with the messaging event.
get_EventType	Returns the type of the event: message or user status.
get_Message	Returns the instant message sent by the remote user.
get_MessageHeader	Returns the header with the content type as sent by the remote user.
get_UserStatus	Returns the user's keystroke status.

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_IRTCMessagingEvent is defined as d3609541-1b29-4de5-a4ad-5aebaf319512.