Funzione WTSLogoffSession (wtsapi32.h)
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) |