DVC 外掛程式註冊

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

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

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

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

    注意

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

     

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

    專案名稱 = 名稱

    資料類型 = REG_SZREG_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. 如果用戶端多次連線到相同或不同的伺服器,則可能會多次呼叫 ConnectedDisconnected 方法。
  4. 外掛程式應該處理的最後一個呼叫是 Terminated。 這是遠端桌面連線 (RDC) 用戶端即將卸載外掛程式的訊號。