IWTSPlugin 接口 (tsvirtualchannels.h)

允许远程桌面连接 (RDC) 客户端加载远程桌面连接 (RDC) 客户端插件。 接口由插件实现,由 RDC 客户端获取和管理。

RDC 客户端通过实例化 COM 对象或调用插件实现的 VirtualChannelGetInstance 函数来获取此接口的实例。 有关如何获取实例的详细信息,请参阅 DVC 插件注册。 在所有情况下,此实例在远程桌面连接 (RDC) 客户端的生存期内保留。

作为 COM 对象,插件必须在自由线程模型中实现。 由于 IWTSPlugin 方法由插件实现,因此插件必须知道调用可能在不同的线程上到达。 调用将始终以串行方式到达,因此不可能有任何两个并行执行的调用。

实现不应阻止这些调用,因为这可能会阻止其他传入连接或现有连接上的数据。

继承

IWTSPlugin 接口继承自 IUnknown 接口。 IWTSPlugin 还具有以下类型的成员:

方法

IWTSPlugin 接口具有这些方法。

 
IWTSPlugin::Connected

通知插件远程桌面连接 (RDC) 客户端已成功连接到远程桌面会话主机 (RD 会话主机) 服务器。
IWTSPlugin::D isconnected

通知插件远程桌面连接 (RDC) 客户端已从远程桌面会话主机 (RD 会话主机) 服务器断开连接。
IWTSPlugin::Initialize

用于从客户端到插件的第一次调用。
IWTSPlugin::Terminated

通知插件远程桌面连接 (RDC) 客户端已终止。

注解

IWTSPlugin 接口由 %System32%\webauthn.dll 实现,以启用远程桌面 WebAuthn 重定向功能。 通过调用 VirtualChannelGetInstance 获取此接口的实例,该实例也由 webauthn.dll 提供。

要求

   
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 tsvirtualchannels.h