IRTCSessionReferredEvent:IDispatch

This interface retrieves information about an event of RTCE_SESSION_REFERRED. This type of event occurs when a session is transferred (referred) or a referred session is accepted.

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 IRTCSessionReferredEvent methods.

Method Description
Session Gets the referred session.
ReferredByURI Gets the URI of the party that initiated the session transfer.
ReferToURI Gets the URI of the party to whom the session is referred, that is, the transfer target.
ReferCookie Gets the cookie for the referred session.
Accept Accepts the session referred event.
Reject Rejects the session referred event.
SetReferredSessionState Sets the state of the referred session.

Obtaining a Pointer

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

Remarks

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

Requirements

OS Versions: Windows CE .NET 4.2 and later.
Header: Rtccore.h, Rtccore.idl.
Link Library: Uuid.lib.

See Also

IDispatch | IDispatch::Invoke | IRTCClient::EventFilter | IRTCEventNotification::Event | IUnknown | RTC_EVENT

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.