Funzione WTSLogoffSession (wtsapi32.h)

  • Articolo

Disconnette una sessione di Servizi Desktop remoto specificata.

Sintassi

BOOL WTSLogoffSession(
  [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. È possibile usare la funzione WTSEnumerateSessions per recuperare gli identificatori di tutte le sessioni in un server host sessione Desktop remoto specificato.

Per poter disconnettersi dalla sessione di un altro utente, è necessario disporre dell'autorizzazione Reimposta. Per altre informazioni, vedere Autorizzazioni di Servizi Desktop remoto. Per modificare le autorizzazioni per una sessione, usare lo strumento di amministrazione configurazione di Servizi Desktop remoto.

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

[in] bWait

Indica se l'operazione è sincrona.

Se bWait è TRUE, la funzione restituisce quando la sessione viene disconnessa.

Se bWait è FALSE, la funzione restituisce immediatamente. Per verificare che la sessione sia stata disconnessa, specificare l'identificatore di sessione in una chiamata alla funzione WTSQuerySessionInformation . WTSQuerySessionInformation restituisce zero se la sessione è disconnessa.

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 (introdotto in Windows 8)

Vedi anche

WTSEnumerateSessions

WTSQuerySessionInformation