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.

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

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

Winuser.h (include Windows.h)

See also

WTSRegisterSessionNotification
WTSUnRegisterSessionNotification

 

 

Show: