The IRTCReInviteEvent interface provides methods that inform the application of a reinvite event for a session that the application is handling session negotiations for. The client application can retrieve the session and accept or reject the re-INVITE. This method initiates a reInvite for the session, not just a media stream.
When the application's implementation of the IRTCEventNotification::Event method indicates an RTC_EVENT of type RTCEF_REINVITE, the method's pEvent parameter is an IDispatch pointer for the IRTCReInviteEvent interface.
Note You must call the IRTCClient::put_EventFilter method and set an event filter mask that includes the RTCEF_REINVITE event to enable reception of ReInvite events. If you do not call IRTCClient::put_EventFilter, your application will not receive any events.
Methods in Vtable Order
The IRTCReInviteEvent interface inherits the methods of the standard COM interfaces:
In addition, IRTCReInviteEvent defines the following methods.
|get_Session||Allows an application to retrieve the SDP sesssion for which the re-INVITE is intended.|
|Accept||Allows the application to specify the content type and body for the response to the re-INVITE.|
|Reject||Allows the application to reject the re-INVITE.|
|get_State||Returns the state of the session reinvite.|
|GetRemoteSessionDescription||Retrieves the session description from the remote client.|
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_IRTCReInviteEvent is defined as 11558D84-204C-43e7-99B0-2034E9417F7D.