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

Voir aussi

ITsSbPlugin

Extensibilité du Répartiteur de connexion Bureau à distance