Sdílet prostřednictvím

Registrace modulu plug-in DVC

  • Článek

Modul plug-in dynamického virtuálního kanálu (DVC) je zaregistrovaný pro použití klientem připojení ke vzdálené ploše (RDC) pomocí jedné z následujících metod:

  • Vyvolání IMsTscAdvancedSettings::p ut_PluginDlls metody ActiveX protokolu RDP (Remote Desktop Protocol). Více položek musí být odděleno čárkami.

  • Zápis položky modulu plug-in do následujícího umístění v registru v počítači, kde je spuštěn proces klienta připojení ke vzdálené ploše (RDC):

    HKEY_CURRENT_USER\Software\Klient terminálového serveru Microsoft\\Výchozí\Doplňky\jedinečný název modulu plug-in

    Poznámka

    Pokud neexistuje, musíte vytvořit jedinečný název modulu plug-in podklíč. jedinečný název modulu plug-in podklíč je libovolný řetězec, který dokáže identifikovat modul plug-in. Řetězec může být libovolná kombinace znaků.

     

    V části jedinečný název modulu plug-inje nutné přidat položku, která identifikuje modul plug-in.

    Název položky = Název

    Datový typ = REG_SZ nebo REG_EXPAND_SZ

V obou případech musí vstupní hodnota odpovídat jednomu z následujících formátů:

"Plug-inDLLName:{CLSID}"

Modul plug-in není nutně registrován v registru Systému Windows jako objekt modelu COM (Component Object Model), ale knihovna DLL je implementována jako objekt modelu COM v procesu. Klient RDC načte knihovnu DLL určenou Plug-inDLLName a načte objekt COM přímo pomocí CLSID.

"Plug-inDLLName"

Knihovna DLL implementuje funkci VirtualChannelGetInstance a exportuje ji podle názvu. Klient RDC použije funkci VirtualChannelGetInstance k získání ukazatelů rozhraní IWTSPlugin pro všechny moduly plug-in implementované knihovnou DLL.

{CLSID}.

Klient RDC vytvoří instanci modulu plug-in jako běžný objekt COM pomocí CoCreateInstance s CLSID.

Poznámka

Plug-inDLLName představuje úplnou cestu a název souboru .dll. Pokud je datový typ REG_EXPAND_SZ, cesta může obsahovat nevyexpandované proměnné prostředí, které jsou rozbalené za běhu.

 

Když klient RDC (Remote Desktop Connection) dokončí inicializaci, provede pro každý zaregistrovaný modul plug-in následující:

  1. Získejte instanci rozhraní IWTSPlugin pro každý modul plug-in pomocí jedné z metod popsaných výše.
  2. Volání metody Initialize každého rozhraní IWTSPlugin.
  3. Pokud se klient připojuje vícekrát ke stejnému serveru nebo k jinému serveru, může existovat více volání Connected a Odpojeno metody.
  4. Poslední volání, které má modul plug-in zpracovat, je Ukončeno. Je to signál, že se klient RDC (Remote Desktop Connection) chystá uvolnit modul plug-in.