Funzione WTSDisconnectSession (wtsapi32.h)

Articolo
03/04/2024

Disconnette l'utente connesso dalla sessione servizi Desktop remoto specificata senza chiudere la sessione. Se l'utente accede successivamente allo stesso server Host sessione Desktop remoto (Host sessione Desktop remoto), l'utente viene riconnesso alla stessa sessione.

Sintassi

BOOL WTSDisconnectSession(
  [in] HANDLE hServer,
  [in] DWORD  SessionId,
  [in] BOOL   bWait
);

Parametri

[in] hServer

Handle per un server host sessione Desktop remoto. Specificare un handle aperto dalla funzione WTSOpenServer o WTSOpenServerEx oppure specificare WTS_CURRENT_SERVER_HANDLE per indicare il server Host sessione Desktop remoto in cui è in esecuzione l'applicazione.

[in] SessionId

Identificatore di sessione di Servizi Desktop remoto. Per indicare la sessione corrente, specificare WTS_CURRENT_SESSION. Per recuperare gli identificatori di tutte le sessioni in un server host sessione Desktop remoto specificato, usare la funzione WTSEnumerateSessions .

Per disconnettere una sessione di un altro utente, è necessario disporre dell'autorizzazione Disconnetti. Per altre informazioni, vedere Autorizzazioni di Servizi Desktop remoto. Per modificare le autorizzazioni in una sessione, usare lo strumento di amministrazione Configurazione servizi Desktop remoto.

Per disconnettere le sessioni in esecuzione in una macchina virtuale ospitata in un server host di virtualizzazione Desktop remoto, è necessario essere un membro del gruppo Administrators nel server host di virtualizzazione Desktop remoto.

[in] bWait

Indica se l'operazione è sincrona. Specificare TRUE per attendere il completamento dell'operazione o false per restituire immediatamente.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	wtsapi32.h
Libreria	Wtsapi32.lib
DLL	Wtsapi32.dll
Set di API	ext-ms-win-session-wtsapi32-l1-1-0 (introdotta in Windows 8)

Vedi anche

WTSEnumerateSessions

Condividi tramite