WlxLoggedOnSAS 函数 (winwlx.h)

  • 项目

[自 Windows Server 2008 和 Windows Vista 起，WlxLoggedOnSAS 函数不再可用。]

WlxLoggedOnSAS 函数必须由替换 GINA DLL 实现。 Winlogon 在用户登录且工作站未锁定时收到 安全关注序列 (SAS) 事件时调用此函数。

注意 在 Windows Vista 中忽略 GINA DLL。
 

语法

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

参数

[in] pWlxContext

指向与此窗口工作站关联的 GINA 上下文的指针。 当 Winlogon 为此工作站调用 WlxInitialize 时，GINA 将返回此上下文值。

[in] dwSasType

指定发生的 SAS 的类型。 保留从零到WLX_SAS_TYPE_MAX_MSFT_VALUE的值以定义标准 Microsoft SAS 类型。 GINA 开发人员可以使用大于 WLX_SAS_TYPE_MAX_MSFT_VALUE 的值定义其他 SAS 类型。

预定义了以下 SAS 类型。

Value 含义
WLX_SAS_TYPE_TIMEOUT
0 (0x0)
 指示在指定的超时期限内未收到任何用户输入。
WLX_SAS_TYPE_CTRL_ALT_DEL
1 (0x1)
 指示用户已键入标准 CTRL+ALT+DEL 安全注意序列 (SAS) 。
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
 通知网络提供商用户更改了其密码。 每当更改密码时，过时的 GINA DLL 都应调用 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 。 GINA DLL 可以通过返回WLX_SAS_ACTION_LOCK_WKSTA来锁定工作站。 返回此值时， Winlogon 将锁定工作站，并在下次收到 SAS 时调用 WlxWkstaLockedSAS 。

在调用 WlxLoggedOnSAS 之前，Winlogon 设置桌面状态，使当前桌面为 Winlogon 桌面，并设置工作站状态，使桌面处于锁定状态。

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 winwlx.h

另请参阅

WlxInitialize

WlxWkstaLockedSAS