Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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.