IWTSSBPlugin::WTSSBX_GetMostSuitableServer-Methode (tssbx.h)
[Die IWTSSBPlugin-Schnittstelle wird nach Windows Server 2008 R2 nicht unterstützt. Ab Windows Server 2012 verwenden Sie bitte die ITsSbPlugin-Schnittstelle.]
Gibt die ID des Servers zurück, an den der Terminaldienste-Sitzungsbroker (TS-Sitzungsbroker) die eingehende Verbindung leiten soll. Die Umleitungslogik des Plug-Ins bestimmt den bevorzugten Server.
Syntax
HRESULT WTSSBX_GetMostSuitableServer(
[in] WCHAR *UserName,
[in] WCHAR *DomainName,
[in] WCHAR *ApplicationType,
[in] WCHAR *FarmName,
[in, out] long *pMachineId
);
Parameter
[in] UserName
Ein Zeiger auf eine Unicode-Zeichenfolge, die den Benutzernamen der eingehenden Verbindung enthält.
[in] DomainName
Ein Zeiger auf eine Unicode-Zeichenfolge, die den Domänennamen enthält, der der eingehenden Verbindung zugeordnet ist.
[in] ApplicationType
Ein Zeiger auf eine Unicode-Zeichenfolge, die den Namen des Programms enthält, das von Remotedesktopdiensten ausgeführt wird, nachdem die Sitzung erstellt wurde.
[in] FarmName
Ein Zeiger auf eine Unicode-Zeichenfolge, die den Namen der Farm im TS-Sitzungsbroker enthält, mit der der Benutzer eine Verbindung herstellt.
[in, out] pMachineId
Ein Zeiger auf die ID des Servers, an den der TS-Sitzungsbroker die eingehende Verbindung umleitet. Dieser Wert wird zunächst auf die ID des Servers festgelegt, der von der Lastenausgleichslogik des TS-Sitzungsbrokers bereitgestellt wird.
Rückgabewert
Gibt bei erfolgreicher Ausführung S_OK zurück.
Hinweise
Verwenden Sie WTSSBX_GetMostSuitableServer , um die Standard-Lastenausgleichslogik des TS-Sitzungsbrokers zu überschreiben. Der TS-Sitzungsbroker ruft diese Methode auf, nachdem eine eigene Lastenausgleichslogik ausgeführt wurde. Der pMachineId-Parameter wird zunächst auf die ID des Servers festgelegt, die von der Lastenausgleichslogik des TS-Sitzungsbrokers bereitgestellt wird. Wenn Sie diese Methode implementieren, kann Ihre Umleitungslogik diese pMachineId oder eine andere pMachineId zurückgeben.
Wenn ein Server einer Farm im TS-Sitzungsbroker beitritt, ruft der TS-Sitzungsbroker die WTSSBX_MachineChangeNotification-Methode auf, um das Plug-In zu benachrichtigen und eine MachineId zum Identifizieren des neuen Servers bereitzustellen. Wenn der TS-Sitzungsbroker WTSSBX_GetMostSuitableServer aufruft, sollte das Plug-In eine der IDs zurückgeben, die der TS-Sitzungsbroker für das Plug-In bereitgestellt hat. Das Plug-In sollte nicht die ID eines Servers zurückgeben, der sich nicht in der Farm befindet.
Bei erfolgreicher Implementierung von WTSSBX_GetMostSuitableServer muss sofort S_OK zurückgegeben werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | tssbx.h |