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 Terminal services Session Broker (TS Session Broker) 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
);

Die 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 remotedesktopdienste nach dem Erstellen der Sitzung ausgeführt wird.

[in] FarmName

Ein Zeiger auf eine Unicode-Zeichenfolge, die den Namen der Farm im TS-Sitzungsbroker enthält, mit dem der Benutzer eine Verbindung herstellt.

[in, out] pMachineId

Ein Zeiger auf die ID des Servers, zu dem 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 S_OK zurück, wenn dies erfolgreich ist.

Bemerkungen

Verwenden Sie WTSSBX_GetMostSuitableServer , um die Standardlogik für den Lastenausgleich des TS-Sitzungsbrokers außer Kraft zu setzen. DER TS-Sitzungsbroker ruft diese Methode auf, nachdem sie eine eigene Lastenausgleichslogik ausgeführt hat. Der Parameter "pMachineId " wird zunächst auf die ID des Servers festgelegt, der von der Lastenausgleichslogik des TS-Sitzungsbrokers bereitgestellt wird. Wenn Sie diese Methode implementieren, kann Ihre Umleitungslogik diese pMachineId oder eine andere je nach Bedarf 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.

Ihre Implementierung von WTSSBX_GetMostSuitableServer muss S_OK sofort zurückgeben, wenn dies erfolgreich ist.

Anforderungen

Siehe auch

ITsSbPlugin

IWTSSBPlugin