Condividi tramite


Registrazione del plug-in DVC

Il plug-in DVC (Dynamic Virtual Channel) viene registrato per l'uso dal client Connessione Desktop remoto (RDC) usando uno dei metodi seguenti:

  • Richiamo del metodo IMsTscAdvancedSettings::p ut_PluginDlls del controllo ActiveX Remote Desktop Protocol (RDP). È necessario separare più voci da virgole.

  • Scrittura della voce del plug-in nel percorso seguente nel Registro di sistema nel computer in cui viene avviato il processo client Connessione Desktop remoto :Scrittura della voce plug-in nel seguente percorso nel Registro di sistema in cui viene avviato il processo client Connessione Desktop remoto:Writing the plug-in entry to the following location in the registry on the computer where the Remote Desktop Connection (RDC) client process is started:

    HKEY_CURRENT_USER\Software\Microsoft\Terminal Server Client\Default\AddIns\nome univoco

    Nota

    Se non esiste, è necessario creare il nome plug-in univoco sottochiave. Il nome plug-in univoco nome della sottochiave è una stringa arbitraria in grado di identificare il plug-in. La stringa può essere qualsiasi combinazione di caratteri.

     

    In nome univoco del plug-in, è necessario aggiungere una voce che identifica il plug-in.

    Nome voce = Nome

    Tipo di dati = REG_SZ o REG_EXPAND_SZ

In entrambi i casi, il valore della voce deve essere conforme a uno dei formati seguenti:

"Plug-inDLLName:{CLSID}"

Il plug-in non è necessariamente registrato nel Registro di sistema di Windows come oggetto COM (Component Object Model), ma la DLL viene implementata come oggetto COM in-process. Il client RDC caricherà la DLL specificata da Plug-inDLLName e recupererà l'oggetto COM direttamente usando CLSID.

"Plug-inDLLName"

La DLL implementa la funzioneVirtualChannelGetInstanceed esportala in base al nome. Il client RDC userà la funzione VirtualChannelGetInstance per ottenere puntatori di interfaccia IWTSPlugin per tutti i plug-in implementati dalla DLL.

"{CLSID}"

Il client RDC creerà un'istanza del plug-in come normale oggetto COM usando CoCreateInstance con CLSID.

Nota

Plug-inDLLName rappresenta il percorso completo e il nome file del file .dll. Se il tipo di dati è REG_EXPAND_SZ, il percorso può contenere variabili di ambiente non espanse in fase di esecuzione.

 

Quando il client Connessione Desktop remoto (RDC) termina l'inizializzazione, eseguirà le operazioni seguenti per ogni plug-in registrato:

  1. Ottenere un'istanza del interfaccia IWTSPlugin per ogni plug-in usando uno dei metodi descritti in precedenza.
  2. Chiamare il metodo Initialize di ogni interfaccia IWTSPlugin.
  3. Se il client si connette più volte allo stesso server o a un server diverso, potrebbero essere presenti più chiamate ai metodi Connected e Disconnected.
  4. L'ultima chiamata che il plug-in deve gestire è Terminato. Si tratta di un segnale che il client Connessione Desktop remoto sta per scaricare il plug-in.