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

Weitere Informationen

ITsSbPlugin

IWTSSBPlugin