DVC 外掛程式註冊

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

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

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

  \ HKEY_CURRENT_USER軟體\微軟\終端機伺服器用戶端\預設\AddIns\唯一外掛程式名稱

  注意

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

   

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

  專案名稱 = 名稱

  資料類型 = REG_SZ 或 REG_EXPAND_SZ

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

「Plug-inDLLName：{CLSID}」

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

「Plug-inDLLName」

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

「{CLSID}」

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

注意

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

 

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

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