IWTSPlugin interface

Allows for the Remote Desktop Connection (RDC) client plug-in to be loaded by the Remote Desktop Connection (RDC) client. The interface is implemented by the plug-in, and is obtained by and managed by the RDC client.

The RDC client obtains an instance of this interface by either instantiating the COM object, or by calling the VirtualChannelGetInstance function implemented by the plug-in. For more information about how the instances are obtained, see DVC plug-in registration. In all cases, this instance is kept for the lifetime of the Remote Desktop Connection (RDC) client.

As a COM object, the plug-in must be implemented in a free-threading model. Because the IWTSPlugin methods are implemented by the plug-in, the plug-in must be aware that the call may arrive on different threads. The calls will always arrive serially, so it is impossible to have any two calls that are executed in parallel.

Implementation should not block these calls because this may block other incoming connections or data on existing connections.

Methods

The IWTSPlugin interface has these methods.

Method Description
IWTSPlugin::Connected Notifies the plug-in that the Remote Desktop Connection (RDC) client has successfully connected to the Remote Desktop Session Host (RD Session Host) server.
IWTSPlugin::Disconnected Notifies the plug-in that the Remote Desktop Connection (RDC) client has disconnected from the Remote Desktop Session Host (RD Session Host) server.
IWTSPlugin::Initialize Used for the first call that is made from the client to the plug-in.
IWTSPlugin::Terminated Notifies the plug-in that the Remote Desktop Connection (RDC) client has terminated.

Requirements

   
Windows version Windows Vista Windows Server 2008
Target Platform Windows
Header tsvirtualchannels.h