Metodo IWTSSBPlugin::WTSSBX_GetMostSuitableServer (tssbx.h)

Articolo
03/03/2024

[L'interfaccia IWTSSBPlugin non è supportata dopo Windows Server 2008 R2. A partire da Windows Server 2012 usare l'interfaccia ITsSbPlugin.

Restituisce l'ID del server a cui Gestore sessione servizi Terminal Services (Gestore sessione TS) deve indirizzare la connessione in ingresso. La logica di reindirizzamento del plug-in determina il server preferito.

Sintassi

HRESULT WTSSBX_GetMostSuitableServer(
  [in]      WCHAR *UserName,
  [in]      WCHAR *DomainName,
  [in]      WCHAR *ApplicationType,
  [in]      WCHAR *FarmName,
  [in, out] long  *pMachineId
);

Parametri

[in] UserName

Puntatore a una stringa Unicode contenente il nome utente della connessione in ingresso.

[in] DomainName

Puntatore a una stringa Unicode contenente il nome di dominio associato alla connessione in ingresso.

[in] ApplicationType

Puntatore a una stringa Unicode contenente il nome del programma eseguito da Servizi Desktop remoto dopo la creazione della sessione.

[in] FarmName

Puntatore a una stringa Unicode contenente il nome della farm in TS Session Broker a cui si connette l'utente.

[in, out] pMachineId

Puntatore all'ID del server a cui Gestore sessione TS reindirizzerà la connessione in ingresso. Questo valore viene inizialmente impostato sull'ID del server fornito dalla logica di bilanciamento del carico di TS Session Broker.

Valore restituito

Restituisce S_OK in caso di esito positivo.

Commenti

Usare WTSSBX_GetMostSuitableServer per eseguire l'override della logica di bilanciamento del carico predefinita di TS Session Broker. TS Session Broker chiama questo metodo dopo l'esecuzione della propria logica di bilanciamento del carico. Il parametro pMachineId viene inizialmente impostato sull'ID del server fornito dalla logica di bilanciamento del carico di TS Session Broker. Quando si implementa questo metodo, la logica di reindirizzamento può restituire questo pMachineId o un altro come appropriato.

Ogni volta che un server viene aggiunto a una farm in Gestore sessioni TS, Gestore sessione TS chiama il metodo WTSSBX_MachineChangeNotification per inviare una notifica al plug-in e fornire un MachineId per identificare il nuovo server. Quando TS Session Broker chiama WTSSBX_GetMostSuitableServer, il plug-in deve restituire uno degli ID forniti da TS Session Broker al plug-in. Il plug-in non deve restituire l'ID di un server che non si trova nella farm.

L'implementazione di WTSSBX_GetMostSuitableServer deve restituire immediatamente S_OK in caso di esito positivo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	tssbx.h

Vedi anche

ITsSbPlugin

IWTSSBPlugin

Condividi tramite