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:
- Ottenere un'istanza del interfaccia IWTSPlugin per ogni plug-in usando uno dei metodi descritti in precedenza.
- Chiamare il metodo Initialize di ogni interfaccia IWTSPlugin.
- 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.
- 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.