WM_WTSSESSION_CHANGE message

Notifies applications of changes in session state.

The window receives this message through its WindowProc function.

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

Parameters

hWnd [in]

Handle to the window.

Msg [in]

Specifies the message (WM_WTSSESSION_CHANGE).

wParam [in]

Status code describing the reason the session state change notification was sent. This parameter can be one of the following values.

Value	Meaning
WTS_CONSOLE_CONNECT 0x1	The session identified by lParam was connected to the console terminal or RemoteFX session.
WTS_CONSOLE_DISCONNECT 0x2	The session identified by lParam was disconnected from the console terminal or RemoteFX session.
WTS_REMOTE_CONNECT 0x3	The session identified by lParam was connected to the remote terminal.
WTS_REMOTE_DISCONNECT 0x4	The session identified by lParam was disconnected from the remote terminal.
WTS_SESSION_LOGON 0x5	A user has logged on to the session identified by lParam.
WTS_SESSION_LOGOFF 0x6	A user has logged off the session identified by lParam.
WTS_SESSION_LOCK 0x7	The session identified by lParam has been locked.
WTS_SESSION_UNLOCK 0x8	The session identified by lParam has been unlocked.
WTS_SESSION_REMOTE_CONTROL 0x9	The session identified by lParam has changed its remote controlled status. To determine the status, call GetSystemMetrics and check the SM_REMOTECONTROL metric.
WTS_SESSION_CREATE 0xA	Reserved for future use.
WTS_SESSION_TERMINATE 0xB	Reserved for future use.

 

lParam [in]

The identifier of the session.

Return value

The return value is ignored.

Remarks

This message is sent only to applications that have registered to receive this message by calling WTSRegisterSessionNotification.

Examples of how applications can respond to this message include releasing or acquiring console-specific resources, determining how a screen is to be painted, or triggering console animation effects.

Requirements

See also

WTSRegisterSessionNotification

WTSUnRegisterSessionNotification

Send comments about this topic to Microsoft

Build date: 10/26/2012