сообщение WM_WTSSESSION_CHANGE

Уведомляет приложения об изменениях в состоянии сеанса.

Окно получает это сообщение через функцию WindowProc .

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

Параметры

hWnd [in]

Дескриптор окна.

Msg [in]

Указывает сообщение (WM_WTSSESSION_CHANGE).

wParam [in]

Код состояния, описывающий причину отправки уведомления об изменении состояния сеанса. Этот параметр может быть одним из следующих значений.

WTS_CONSOLE_CONNECT (0x1)

Сеанс, определенный lParam , был подключен к терминалу консоли или сеансу RemoteFX.

WTS_CONSOLE_DISCONNECT (0x2)

Сеанс, определенный lParam , был отключен от терминала консоли или сеанса RemoteFX.

WTS_REMOTE_CONNECT (0x3)

Сеанс, определяемый lParam , был подключен к удаленному терминалу.

WTS_REMOTE_DISCONNECT (0x4)

Сеанс, определенный lParam , был отключен от удаленного терминала.

WTS_SESSION_LOGON (0x5)

Пользователь вошел в сеанс, определенный lParam.

WTS_SESSION_LOGOFF (0x6)

Пользователь выполнил вход в сеанс, определенный lParam.

WTS_SESSION_LOCK (0x7)

Сеанс, определенный lParam , заблокирован.

WTS_SESSION_UNLOCK (0x8)

Сеанс, определенный lParam , был разблокирован.

WTS_SESSION_REMOTE_CONTROL (0x9)

Сеанс, определяемый lParam , изменил состояние удаленного управления. Чтобы определить состояние, вызовите GetSystemMetrics и проверьте метрику SM_REMOTECONTROL .

WTS_SESSION_CREATE (0xA)

Зарезервировано для дальнейшего использования.

WTS_SESSION_TERMINATE (0xB)

Зарезервировано для дальнейшего использования.

WTS_SESSION_DESKTOP_READY (0xF)

Сеанс, определенный lParam , переключился на рабочий стол пользователя.

Возвращаемое значение

Возвращаемое значение игнорируется.

Замечания

Это сообщение отправляется только приложениям, зарегистрированным для получения этого сообщения, вызвав WTSRegisterSessionNotification.

Примеры того, как приложения могут реагировать на это сообщение, включают освобождение или получение ресурсов, относящихся к консоли, определение способа нарисовки экрана или активация эффектов анимации консоли.

Требования

См. также

WTSRegisterSessionNotification

WTSUnRegisterSessionNotification