Export (0) Print
Expand All

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.

Members

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

Methods

The IWTSPlugin interface has these methods.

MethodDescription
Connected

Notifies the plug-in that the Remote Desktop Connection (RDC) client has successfully connected to the RD Session Host server.

Disconnected

Notifies the plug-in that the Remote Desktop Connection (RDC) client has disconnected from the RD Session Host server.

Initialize

Used for the first call that is made from the client to the plug-in.

Terminated

Notifies the plug-in that the Remote Desktop Connection (RDC) client has terminated.

 

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Version

Remote Desktop Connection (RDC) 6.1 for Windows XP (KB952155).

Header

Tsvirtualchannels.h

IDL

Tsvirtualchannels.idl

 

 

Show:
© 2014 Microsoft