IRTCClient2
The IRTCClient2 interface contains additional methods and properties for the client object, extending the IRTCClient interface. A client can be obtained using CoCreateInstance for CLSID_RTCClient (GUID = {7a42ea29-a2b7-40c4-b091-f6f024aa89be}), which can be subsequently queried for the presence of IRTCClient2 using QueryInterface. The object can be used as an inproc server only.
Methods in Vtable Order
The IRTCClient2 interface inherits the methods of the standard COM interface IUnknown.
In addition, IRTCClient2 defines the following methods, including those inherited from IRTCClient.
| Method | Description |
|---|---|
| put_AnswerMode | Sets the answer mode for a session type. This controls if an incoming call will be automatically answered, automatically rejected, or if it will be notified to the application to make the decision. |
| get_AnswerMode | Sets the answer mode for a session type. This controls if an incoming call will be automatically answered, automatically rejected, or if it will be notified to the application to make the decision. |
| InvokeTuningWizardEx | Invokes the tuning wizard, and permits the user to specify whether audio and/or video tuning is allowed. |
| get_Version | Returns the version of a client. |
| put_ClientName | Specifies the name of the application that will be used in the User-Agent header. |
| put_ClientCurVer | The version of the RTC Client API that the application is using. |
| InitializeEx | Performs all the operations of the IRTCClient::Initialize method. In addition, this method specifies the mode of initialization of the Client object. |
| CreateSessionWithDescription | Creates a new session and specifies that the application will be responsible for all negotiations for the session. |
| SetSessionDescriptionManager | Provides a pointer to the IRTCSessionDescriptionManager interface that will handle the session negotiations. |
| put_PreferredSecurityLevel | Specifies the required encryption level for each media type. |
| get_PreferredSecurityLevel | Returns the required encryption level for each media type. |
| put_AllowedPorts | Sets the way that the Client listens for incoming sessions. |
| get_AllowedPorts | Retrieves the way that the Client listens for incoming sessions. |
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_IRTCClient2 is defined as 0C91D71D-1064-42da-BFA5-572BEB8EEA84.