Функция WlxLoggedOnSAS (winwlx.h)

  • Статья

[Функция WlxLoggedOnSAS больше недоступна для использования в Windows Server 2008 и Windows Vista.]

Функция WlxLoggedOnSAS должна быть реализована с помощью библиотеки DLL GINA . Winlogon вызывает эту функцию, когда получает событие SAS , когда пользователь вошел в систему, а рабочая станция не заблокирована.

Примечание Библиотеки DLL GINA игнорируются в Windows Vista.
 

Синтаксис

int WlxLoggedOnSAS(
  [in] PVOID pWlxContext,
  [in] DWORD dwSasType,
  [in] PVOID pReserved
);

Параметры

[in] pWlxContext

Указатель на контекст GINA, связанный с этой станцией окон. GINA возвращает это контекстное значение, когда Winlogon вызывает WlxInitialize для этой станции.

[in] dwSasType

Указывает тип возникного SAS. Значения от нуля до WLX_SAS_TYPE_MAX_MSFT_VALUE зарезервированы для определения стандартных типов SAS Майкрософт. Разработчики GINA могут определять дополнительные типы SAS, используя значения, превышающие WLX_SAS_TYPE_MAX_MSFT_VALUE.

Следующие типы SAS являются предопределенными.

Значение Значение
WLX_SAS_TYPE_TIMEOUT
0 (0x0)
 Указывает, что в течение указанного периода времени ожидания пользователь не получал входные данные.
WLX_SAS_TYPE_CTRL_ALT_DEL
1 (0x1)
 Указывает, что пользователь ввел стандартную последовательность безопасного внимания (SAS) CTRL+ALT+DEL.
WLX_SAS_TYPE_SC_INSERT
5 (0x5)
 Указывает, что смарт-карта был вставлен в совместимое устройство.
WLX_SAS_TYPE_SC_REMOVE
6 (0x6)
 Указывает, что смарт-карта удалена с совместимого устройства.

[in] pReserved

Этот параметр зарезервирован и должен иметь значение NULL.

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

Функция WlxLoggedOnSAS должна возвращать одно из следующих значений.

Код возврата Описание
WLX_SAS_ACTION_NONE
 Возвращается на рабочий стол по умолчанию.
WLX_SAS_ACTION_LOCK_WKSTA
 Блокирует рабочую станцию и ожидает следующего SAS.
WLX_SAS_ACTION_LOGOFF
 Регистрирует пользователя с рабочей станции.
WLX_SAS_ACTION_SHUTDOWN
 Записывает пользователя в журнал и завершает работу компьютера.
WLX_SAS_ACTION_SHUTDOWN_REBOOT
 Выключает пользователя, завершает работу компьютера, а затем перезагружает компьютер.
WLX_SAS_ACTION_SHUTDOWN_POWER_OFF
 Если оборудование позволяет, пользователь выключается, завершает работу компьютера, а затем отключает компьютер.
WLX_SAS_ACTION_PWD_CHANGED
 Уведомляет сетевых поставщиков о том, что пользователь изменил свой пароль. Устаревшие библиотеки DLL GINA должны вызывать WlxChangePasswordNotify при каждом изменении пароля.
WLX_SAS_ACTION_TASKLIST
 Вызывает список задач.
WLX_SAS_ACTION_FORCE_LOGOFF
 Принудительно выполняет выход пользователя из системы.
WLX_SAS_ACTION_SHUTDOWN_SLEEP
 Переводит компьютер в режим приостановки.
WLX_SAS_ACTION_SHUTDOWN_SLEEP2
 Завершает работу системы в состоянии выключения питания ACPI. Если компьютер не является компьютером ACPI, этот параметр не будет действовать.
WLX_SAS_ACTION_SHUTDOWN_HIBERNATE
 Завершает работу системы в режим гибернации. Если в системе не настроен режим гибернации, этот параметр не будет действовать.

Комментарии

Winlogon вызывает WlxLoggedOnSAS , когда пользователь, выполнивший вход, хочет завершить работу, выйти из системы или заблокировать рабочую станцию. Библиотека DLL GINA может заблокировать рабочую станцию, возвращая WLX_SAS_ACTION_LOCK_WKSTA. Когда это значение возвращается, Winlogon блокирует рабочую станцию и вызывает WlxWkstaLockedSAS при следующем получении SAS.

Перед вызовом WlxLoggedOnSAS Winlogon устанавливает состояние рабочего стола таким образом, чтобы текущий рабочий стол был рабочим столом Winlogon, а состояние рабочей станции — так, чтобы рабочий стол был заблокирован.

Требования

   
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header winwlx.h

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

WlxInitialize

WlxWkstaLockedSAS