Interface IWTSSBPlugin (tssbx.h)
[ L’interface IWTSSBPlugin n’est pas prise en charge après Windows Server 2008 R2. À partir de Windows Server 2012 utilisez l’interface ITsSbPlugin.]
Utilisé pour étendre les fonctionnalités de Terminal Services Session Broker (TS Session Broker). Implémentez cette interface lorsque vous souhaitez fournir un plug-in qui remplace la logique de redirection de TS Session Broker.
Héritage
L’interface IWTSSBPlugin hérite de l’interface IUnknown. IWTSSBPlugin possède également les types de membres suivants :
Méthodes
L’interface IWTSSBPlugin possède ces méthodes.
| IWTSSBPlugin ::Initialize Initialise le plug-in et retourne une valeur qui indique les fonctionnalités de redirection du plug-in. |
| IWTSSBPlugin ::Terminated Avertit le plug-in qu’il est sur le point d’être détruit par Terminal Services Session Broker (TS Session Broker). |
| IWTSSBPlugin ::WTSSBX_GetMostSuitableServer Retourne l’ID du serveur vers lequel le Répartiteur de sessions Terminal Services (TS Session Broker) doit diriger la connexion entrante. |
| IWTSSBPlugin ::WTSSBX_GetUserExternalSession Redirige une connexion entrante à une ressource informatique, telle qu’une machine virtuelle, un serveur de panneau ou même le bureau d’entreprise de l’utilisateur en fournissant une structure WTSSBX_MACHINE_CONNECT_INFO qui contient des informations sur la ressource. |
| IWTSSBPlugin ::WTSSBX_MachineChangeNotification Avertit le plug-in qu’une modification s’est produite dans l’environnement serveur. |
| IWTSSBPlugin ::WTSSBX_SessionChangeNotification Avertit le plug-in qu’une modification, telle qu’une ouverture de session, une déconnexion, une déconnexion ou une reconnexion, s’est produite dans la session. |
Remarques
TS Session Broker appelle la méthode WTSSBX_GetUserExternalSession afin que le plug-in puisse diriger une connexion entrante vers un ordinateur qui n’appartient pas à une batterie de serveurs dans TS Session Broker.
Le répartiteur de session TS appelle également la méthode WTSSBX_GetMostSuitableServer afin que le plug-in puisse diriger une connexion entrante vers un ordinateur qui appartient à une batterie de serveurs dans TS Session Broker.
Ces méthodes référencent un serveur individuel dans la batterie à l’aide du MachineId unique attribué au serveur par TS Session Broker. Lorsqu’un serveur rejoint une batterie de serveurs dans TS Session Broker, TS Session Broker appelle la méthode WTSSBX_MachineChangeNotification pour notifier le plug-in de la modification et passer le MachineId du nouveau serveur au plug-in.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Aucun pris en charge |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | tssbx.h |