IWTSPlugin interface (tsvirtualchannels.h)

  • Article

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.

Inheritance

The IWTSPlugin interface inherits from the IUnknown interface. IWTSPlugin also has these types of members:

Methods

The IWTSPlugin interface has these methods.

 
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.

Remarks

The IWTSPlugin interface is implemented by %System32%\webauthn.dll to enable the Remote Desktop WebAuthn redirection functionality. Get an instance of this interface by calling VirtualChannelGetInstance, which is also provided by webauthn.dll.

Requirements

Requirement Value
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header tsvirtualchannels.h