WlxInitialize 函数 (winwlx.h)
[自 Windows Server 2008 和 Windows Vista 起,WlxInitialize 函数不再可用。]
WlxInitialize 函数必须由替换 GINA DLL 实现。 Winlogon 为计算机上的每个窗口工作站调用此函数一次。 目前,操作系统支持每个工作站一个窗口工作站。
语法
BOOL WlxInitialize(
[in] LPWSTR lpWinsta,
[in] HANDLE hWlx,
[in] PVOID pvReserved,
[in] PVOID pWinlogonFunctions,
[out] PVOID *pWlxContext
);
参数
[in] lpWinsta
指向正在初始化的窗口站名称的指针。
[in] hWlx
Winlogon 的句柄。 GINA 必须在对涉及此窗口工作站的 Winlogon 支持函数的所有调用中提供此句柄。
[in] pvReserved
此参数保留供将来使用,必须设置为 NULL。
[in] pWinlogonFunctions
指向 Winlogon 支持函数调度表的指针。 表的内容取决于 WlxNegotiate 调用返回的 GINA DLL 版本。 此表不会更改,这允许 GINA DLL 在不复制表的情况下引用表。 如果 GINA DLL 需要创建表的副本,它应调用 WlxGetOption 并为 Option 参数提供WLX_OPTION_DISPATCH_TABLE_SIZE。
值 | 含义 |
---|---|
Winlogon 调度表 - 版本 1.4 | |
Winlogon 调度表 - 版本 1.3 | |
Winlogon 调度表 - 版本 1.2 | |
Winlogondispatch 表 - 版本 1.1 | |
Winlogon 调度表 - 版本 1.0 |
[out] pWlxContext
指向 VOID 的指针的指针,该 VOID 将包含此窗口工作站的 GINA 上下文的地址。 此上下文在从 Winlogon 对 GINA 的所有后续调用中传递。 GINA DLL 管理上下文使用的任何内存。 稍后可以通过使用 WLX_OPTION_CONTEXT_POINTER调用 WlxSetOption 函数来更改上下文指针。
返回值
如果函数成功初始化 GINA DLL,则函数返回 TRUE。
如果函数失败,或者 GINA DLL 未初始化,则函数返回 FALSE。 Winlogon 将终止,系统不会启动。
注解
对于计算机上的每个窗口工作站,将调用一次 WlxInitialize。
目前仅支持名为 Winsta0 的单个窗口工作站。
在调用 WlxInitialize 之前,Winlogon 设置桌面状态,使当前桌面为 Winlogon 桌面,并设置工作站状态,使桌面处于锁定状态。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | winwlx.h |