DVC 外掛程式註冊
動態虛擬通道 (DVC) 外掛程式會使用下列其中一種方法註冊,以供遠端桌面連線 (RDC) 用戶端使用:
叫用遠端桌面通訊協定 (RDP) ActiveX 控件的 IMsTscAdvancedSettings::p ut_PluginDlls 方法。 多個項目必須以逗號分隔。
在啟動遠端桌面連線 (RDC) 用戶端進程之電腦上的登錄中,將外掛程式專案寫入下列位置:
HKEY_CURRENT_USER\Software\Microsoft\Terminal Server Client\Default\AddIns\唯一外掛程式名稱
注意
如果子機碼不存在,您必須建立 唯一外掛程式名稱。 唯一外掛程式名稱 子機碼名稱是可識別外掛程式的任意字串。 字串可以是字元的任何組合。
在 [唯一外掛程式名稱下,您必須新增可識別外掛程式的專案。
項目名稱 = Name
數據類型 = REG_SZ 或 REG_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) 用戶端完成初始化時,它會針對每個已註冊的外掛程式執行下列動作:
- 使用上述其中一個方法,取得每個外掛程式 IWTSPlugin 介面的實例。
- 呼叫每個 IWTSPlugin 介面 Initialize 方法。
- 如果用戶端多次連線到相同或不同的伺服器,則可能會多次呼叫連線 連線,並 已中斷連線 方法。
- 外掛程式應處理的最後一個呼叫 終止。 這是遠端桌面連線 (RDC) 用戶端即將卸除外掛程式的訊號。