Interface IWTSPlugin (tsvirtualchannels.h)
Permet au plug-in client de connexion Bureau à distance (RDC) d’être chargé par le client de connexion Bureau à distance (RDC). L’interface est implémentée par le plug-in et est obtenue par et gérée par le client RDC.
Le client RDC obtient une instance de cette interface en instanciant l’objet COM ou en appelant la fonction VirtualChannelGetInstance implémentée par le plug-in. Pour plus d’informations sur la façon dont les instances sont obtenues, consultez Inscription du plug-in DVC. Dans tous les cas, cette instance est conservée pendant toute la durée de vie du client de connexion Bureau à distance (RDC).
En tant qu’objet COM, le plug-in doit être implémenté dans un modèle de thread libre. Étant donné que les méthodes IWTSPlugin sont implémentées par le plug-in, le plug-in doit savoir que l’appel peut arriver sur différents threads. Les appels arrivent toujours en série, il est donc impossible d’avoir deux appels exécutés en parallèle.
L’implémentation ne doit pas bloquer ces appels, car cela peut bloquer d’autres connexions entrantes ou données sur des connexions existantes.
Héritage
L’interface IWTSPlugin hérite de l’interface IUnknown. IWTSPlugin a également les types de membres suivants :
Méthodes
L’interface IWTSPlugin utilise ces méthodes.
| IWTSPlugin::Connected Avertit le plug-in que le client de connexion Bureau à distance (RDC) s’est correctement connecté au serveur Hôte de session Bureau à distance (hôte de session Bureau à distance). |
| IWTSPlugin::D isconnected Avertit le plug-in que le client de connexion Bureau à distance (RDC) s’est déconnecté du serveur Hôte de session Bureau à distance (hôte de session Bureau à distance). |
| IWTSPlugin::Initialize Utilisé pour le premier appel effectué à partir du client vers le plug-in. |
| IWTSPlugin::Terminated Avertit le plug-in que le client de connexion Bureau à distance (RDC) s’est arrêté. |
Remarques
L’interface IWTSPlugin est implémentée par %System32%\webauthn.dll pour activer la fonctionnalité de redirection WebAuthn bureau à distance. Obtenez une instance de cette interface en appelant VirtualChannelGetInstance, qui est également fourni par webauthn.dll.
Configuration requise
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | tsvirtualchannels.h |