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.
| Method | Description |
|---|---|
| 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 [desktop apps only] |
|---|---|
|
Minimum supported server | Windows Server 2008 [desktop apps only] |
|
Version | Remote Desktop Connection (RDC) 6.1 for Windows XP (KB952155). |
|
Header |
|
|
IDL |
|
Send comments about this topic to Microsoft
Build date: 10/26/2012