共用方式為


DVC 外掛程式註冊

動態虛擬通道 (DVC) 外掛程式會使用下列其中一種方法註冊,以供遠端桌面連線 (RDC) 用戶端使用:

  • 叫用遠端桌面通訊協定 (RDP) ActiveX 控件的 IMsTscAdvancedSettings::p ut_PluginDlls 方法。 多個項目必須以逗號分隔。

  • 在啟動遠端桌面連線 (RDC) 用戶端進程之電腦上的登錄中,將外掛程式專案寫入下列位置:

    HKEY_CURRENT_USER\Software\Microsoft\Terminal Server Client\Default\AddIns\唯一外掛程式名稱

    注意

    如果子機碼不存在,您必須建立 唯一外掛程式名稱唯一外掛程式名稱 子機碼名稱是可識別外掛程式的任意字串。 字串可以是字元的任何組合。

     

    在 [唯一外掛程式名稱下,您必須新增可識別外掛程式的專案。

    項目名稱 = Name

    數據類型 = REG_SZREG_EXPAND_SZ

在這兩種情況下,專案值必須符合下列其中一種格式:

外掛程式DLLName:{CLSID}”

外掛程式不一定會在 Windows 登錄中註冊為元件物件模型 (COM) 物件,但 DLL 會實作為同進程 COM 物件。 RDC 用戶端會載入由 Plug-inDLLName 指定的 DLL,並使用 CLSID直接擷取 COM 物件。

外掛程式DLLName

DLL 會實作 VirtualChannelGetInstance 函式,並依名稱匯出它。 RDC 用戶端會使用 VirtualChannelGetInstance 函式,針對 DLL 實作的所有外掛程式取得 IWTSPlugin 介面指標。

“{CLSID}”

RDC 用戶端會使用 CoCreateInstance 搭配 CLSID將外掛程式具現化為一般 COM 物件。

注意

外掛程式DLLName 代表 .dll 檔案的完整路徑和檔名。 如果數據類型是 REG_EXPAND_SZ,路徑可以包含在運行時間展開的未展開環境變數。

 

當遠端桌面連線 (RDC) 用戶端完成初始化時,它會針對每個已註冊的外掛程式執行下列動作:

  1. 使用上述其中一個方法,取得每個外掛程式 IWTSPlugin 介面的實例。
  2. 呼叫每個 IWTSPlugin 介面 Initialize 方法。
  3. 如果用戶端多次連線到相同或不同的伺服器,則可能會多次呼叫連線 連線,並 已中斷連線 方法。
  4. 外掛程式應處理的最後一個呼叫 終止。 這是遠端桌面連線 (RDC) 用戶端即將卸除外掛程式的訊號。