IRTCSessionReferStatusEvent
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. |
Remarks
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.
Requirements
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.