IRTCMessagingEvent:IDispatch
This interface retrieves information about an event of type RTCE_MESSAGING. This type of event is triggered when an incoming instant message arrives, or when an update of the remote user's keystroke status is received.
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 IDispatch interfaces.
The following table shows the IDispatch methods.
| Method | Description |
|---|---|
| GetIDsOfNames | Maps a single member name and an optional set of parameter names to a corresponding set of integer dispatch identifiers (DISPIDs). These identifiers can then be used on subsequent calls to IDispatch::Invoke. |
| GetTypeInfo | Retrieves the type information for an object. |
| GetTypeInfo | Retrieves the number of type information interfaces provided by an object, either zero (0) or 1. |
| Invoke | Provides access to properties and methods exposed by an object. |
The following table shows the IRTCMessagingEvent methods.
| Method | Description |
|---|---|
| Session | Gets the session associated with the messaging event. |
| Participant | Gets the participant associated with the messaging event. |
| EventType | Gets the type of event, either message or user status. |
| Message | Gets the instant message sent by the remote user. |
| MessageHeader | Gets the message header with the content type, as sent by the remote user. |
| UserStatus | Gets the user keystroke status. |
Obtaining a Pointer
When the application's implementation of the IRTCEventNotification::Event method indicates an RTC_EVENT enumeration value of RTCE_MESSAGING, the method's pEvent parameter is an IDispatch pointer for the IRTCMessagingEvent interface.
Remarks
To enable reception of messaging events, the application must call the IRTCClient::EventFilter method and set an event filter mask that includes the RTCE_MESSAGING event. If the application does not call IRTCClient::EventFilter, it will not receive any events.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Rtccore.h, Rtccore.idl.
Link Library: Uuid.lib.
See Also
Communications Service | IDispatch | IDispatch::Invoke | IRTCClient::EventFilter | IRTCEventNotification::Event | IUnknown | RTC_EVENT
Last updated on Saturday, April 10, 2004
© 1992-2003 Microsoft Corporation. All rights reserved.