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