Partager via

IRTCPresencePropertyEvent (Windows Embedded CE 6.0)

  • Article

1/6/2010

Note

This interface is unsupported in Windows Embedded CE 6.0.

This interface retrieves information about an event of type RTCE_PRESENCE_PROPERTY. This type of event is used after a change in the state of a presence property.

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

IDispatch::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.

IDispatch::GetTypeInfo

Retrieves the type information for an object.

IDispatch::GetTypeInfoCount

Retrieves the number of type information interfaces provided by an object, either zero (0) or 1.

IDispatch::Invoke

Provides access to properties and methods exposed by an object.

The following table shows the IRTCPresencePropertyEvent methods.

Method Description

IRTCPresencePropertyEvent::StatusCode

Gets the result code of the completed operation.

IRTCPresencePropertyEvent::StatusText

Gets the text message corresponding to the result code of the completed operation.

IRTCPresencePropertyEvent::PresenceProperty

Gets the presence property related to the completed operation.

IRTCPresencePropertyEvent::Value

Gets the value related to the presence property.

Obtaining a Pointer

When the application's implementation of the IRTCEventNotification::Event method indicates an RTC_EVENT enumeration value of RTCE_PRESENCE_PROPERTY, the method's pEvent parameter is an IDispatch pointer for the IRTCPresencePropertyEvent interface.

Remarks

To enable reception of presence property events, the application must call the IRTCClient::EventFilter method and set an event filter mask that includes the RTCE_PRESENCE_PROPERTY event. If the application does not call IRTCClient::EventFilter, it will not receive any events.

Requirements

Header rtccore.h, rtccore.idl
Library rtcdll.dll
Windows Embedded CE Windows CE .NET 4.2 and later

See Also

Reference

RTC Client API Interfaces