The IRTCSessionReferStatusEvent interface provides methods to inform the application of the status of the referred session.

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

Note  You must call the IRTCClient::put_EventFilter method and set an event filter mask that includes the RTCE_SESSION_REFER_STATUS event to enable reception of info events. If you do not call IRTCClient::put_EventFilter, your application will not receive any events.

Methods in Vtable Order

The IRTCSessionReferStatusEvent interface inherits the methods of the standard COM interfaces:

In addition, IRTCSessionReferStatusEvent defines the following methods.

Method Description
get_Session Returns the session that is being referred.
get_ReferStatus Returns the status of the referred session.
get_StatusCode Returns the status code of the referred session.
get_StatusText Returns the status text for the referred session.


The RTCEF_SESSION_REFER_STATUS event is fired to the application that initiates a session transfer on a connected call by calling the IRTCSessionCallControl::Refer method. This event notifies the application of the status of the call being created between the transferred endpoint and the transfer target endpoint.


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_IRTCSessionReferStatusEvent is defined as 3D8FC2CD-5D76-44AB-BB68-2A80353B34A2.

See Also

IRTCEventNotification::Event, Session Control