Поделиться через


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]

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

Сообщение [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)

Зарезервировано для последующего использования.

lParam [in]

Идентификатор сеанса.

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

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

Комментарии

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

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

Требования

Требование Значение
Минимальная версия клиента
Windows Vista
Минимальная версия сервера
Windows Server 2008
Заголовок
Winuser.h (включая Windows.h)

См. также раздел

WTSRegisterSessionNotification

WTSUnRegisterSessionNotification