messaggio WM_WTSSESSION_CHANGE

Articolo
06/22/2023

Notifica alle applicazioni le modifiche apportate allo stato della sessione.

La finestra riceve questo messaggio tramite la relativa funzione WindowProc .

LRESULT CALLBACK WindowProc(
  HWND hWnd,       // handle to window
  UINT Msg,        // WM_WTSSESSION_CHANGE
  WPARAM wParam,   // session state change event
  LPARAM lParam    // session ID
);

Parametri

hWnd [in]: Handle per la finestra.
Messaggio [in]: Specifica il messaggio (WM_WTSSESSION_CHANGE).
wParam [in]: Codice di stato che descrive il motivo per cui è stata inviata la notifica di modifica dello stato della sessione. Questo parametro può avere uno dei valori seguenti.
WTS_CONSOLE_CONNECT (0x1): La sessione identificata da lParam è stata connessa al terminale della console o alla sessione RemoteFX.
WTS_CONSOLE_DISCONNECT (0x2 ): La sessione identificata da lParam è stata disconnessa dal terminale della console o dalla sessione RemoteFX.
WTS_REMOTE_CONNECT (0x3): La sessione identificata da lParam è stata connessa al terminale remoto.
WTS_REMOTE_DISCONNECT (0x4): La sessione identificata da lParam è stata disconnessa dal terminale remoto.
WTS_SESSION_LOGON (0x5): Un utente ha eseguito l'accesso alla sessione identificata da lParam.
WTS_SESSION_LOGOFF (0x6 ): Un utente ha disconnesso la sessione identificata da lParam.
WTS_SESSION_LOCK (0x7): La sessione identificata da lParam è stata bloccata.
WTS_SESSION_UNLOCK (0x8 ): La sessione identificata da lParam è stata sbloccata.
WTS_SESSION_REMOTE_CONTROL (0x9): La sessione identificata da lParam ha modificato lo stato di controllo remoto. Per determinare lo stato, chiamare GetSystemMetrics e controllare la metrica SM_REMOTECONTROL .
WTS_SESSION_CREATE (0xA): Riservato per utilizzi futuri.
WTS_SESSION_TERMINATE (0xB): Riservato per utilizzi futuri.

lParam [in]

Identificatore della sessione.

Valore restituito

Il valore restituito viene ignorato.

Commenti

Questo messaggio viene inviato solo alle applicazioni registrate per ricevere questo messaggio chiamando WTSRegisterSessionNotification.

Esempi di come le applicazioni possono rispondere a questo messaggio includono il rilascio o l'acquisizione di risorse specifiche della console, la determinazione della modalità di disegno di uno schermo o l'attivazione di effetti di animazione della console.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Intestazione	Winuser.h (include Windows.h)

Vedi anche

WTSRegisterSessionNotification
WTSUnRegisterSessionNotification