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