Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

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.

See Also

IRTCEventNotification::Event, Session Control

 

Show:
© 2015 Microsoft