IRTCReInviteEvent

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.

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

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_IRTCReInviteEvent is defined as 11558D84-204C-43e7-99B0-2034E9417F7D.

 

Show: