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） 用戶端完成初始化時，它會針對每個已註冊的外掛程式執行下列動作：

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