Export (0) Print
Expand All

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.

ValueMeaning
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 2003

Header

Winuser.h (include Windows.h)

See also

WTSRegisterSessionNotification
WTSUnRegisterSessionNotification

 

 

Show:
© 2014 Microsoft