大网数据广告活动
账户与安全

Interaction Between Winlogon and GINA

· 52CE 我爱测

Winlogon and the GINA must communicate initialization information, handle secure attention sequence (SAS) monitoring and notification, and permit logoff and shutdown activities.

Winlogon and the GINA must communicate initialization information, handle secure attention sequence (SAS) monitoring and notification, and permit logoff and shutdown activities. The state of Winlogon determines which GINA function is called to process any given SAS event. Communications occur in the order shown here.

Note:
GINA DLLs are ignored in Windows Vista.

Event Description
Workstation boot <ol><li>Winlogon calls the GINA's <a href="/windows/desktop/api/Winwlx/nf-winwlx-wlxnegotiate">WlxNegotiate</a> function to notify the GINA about the version of Winlogon in use.</li><li>Winlogon calls the GINA's <a href="/windows/desktop/api/Winwlx/nf-winwlx-wlxinitialize">WlxInitialize</a> function to give the GINA the addresses of the support functions, a handle to Winlogon, and to obtain the <a href="/windows/desktop/SecGloss/c-gly">context</a> information for the GINA (to be used in all future calls to the GINA). Winlogon is in the logged-out state.</li></ol>
No one is logged on (The GINA monitors devices for SAS events).<ol><li>The GINA calls Winlogon's <a href="/windows/desktop/api/winwlx/nc-winwlx-pwlx_sas_notify">WlxSasNotify</a> function when a SAS event has been received.</li><li>Winlogon calls the GINA's <a href="/windows/desktop/api/Winwlx/nf-winwlx-wlxloggedoutsas">WlxLoggedOutSAS</a> function, allowing the GINA to process a user's identification and authentication information. When logon is successful, Winlogon is in the logged-on state.</li></ol>
The user is logged on (The GINA monitors devices for SAS events).<ol><li>The GINA calls Winlogon's <a href="/windows/desktop/api/winwlx/nc-winwlx-pwlx_sas_notify">WlxSasNotify</a> function when a SAS event has been received.</li><li>Winlogon calls the GINA's <a href="/windows/desktop/api/Winwlx/nf-winwlx-wlxloggedonsas">WlxLoggedOnSAS</a> function, allowing the GINA to present options to the user who is currently logged on.</li></ol>
The user is logged on and wants to lock computer (The GINA monitors devices for SAS events).<ol><li>The GINA calls the <a href="/windows/desktop/api/winwlx/nc-winwlx-pwlx_sas_notify">WlxSasNotify</a> function.</li><li>Winlogon calls the GINA's <a href="/windows/desktop/api/Winwlx/nf-winwlx-wlxloggedonsas">WlxLoggedOnSAS</a> function.</li><li>The GINA returns WLX_SAS_ACTION_LOCK_WKSTA. Winlogon is in the workstation-locked state.</li></ol>
The user is logged on, the workstation is locked, and the user wants to unlock computer (The GINA monitors devices for SAS events).<ol><li>The GINA calls the <a href="/windows/desktop/api/winwlx/nc-winwlx-pwlx_sas_notify">WlxSasNotify</a> function.</li><li>Winlogon calls the GINA's <a href="/windows/desktop/api/Winwlx/nf-winwlx-wlxwkstalockedsas">WlxWkstaLockedSAS</a> function.</li><li>The GINA returns WLX_SAS_ACTION_UNLOCK_WKSTA.</li></ol>
The user is logged on, and the program calls the <a href="/windows/desktop/api/winuser/nf-winuser-exitwindowsex">ExitWindowsEx</a> function Winlogon calls the GINA's <a href="/windows/desktop/api/Winwlx/nf-winwlx-wlxlogoff">WlxLogoff</a> function.
The user is logged on and wants to log off by using SAS (The GINA monitors devices for SAS events).<ol><li>The GINA calls the <a href="/windows/desktop/api/winwlx/nc-winwlx-pwlx_sas_notify">WlxSasNotify</a> function.</li><li>Winlogon calls the GINA's <a href="/windows/desktop/api/Winwlx/nf-winwlx-wlxloggedonsas">WlxLoggedOnSAS</a> function.</li><li>The GINA returns WLX_SAS_ACTION_LOGOFF.</li><li>Winlogon calls the GINA's <a href="/windows/desktop/api/Winwlx/nf-winwlx-wlxlogoff">WlxLogoff</a> function.</li></ol>
The user is logged on and wants to log off and shut down by using <a href="/windows/desktop/api/winuser/nf-winuser-exitwindowsex">ExitWindowsEx</a> <ol><li>Winlogon calls the GINA's <a href="/windows/desktop/api/Winwlx/nf-winwlx-wlxlogoff">WlxLogoff</a> function.</li><li>Winlogon calls the GINA's <a href="/windows/desktop/api/Winwlx/nf-winwlx-wlxshutdown">WlxShutdown</a> function.</li></ol>
The user is logged on and wants to log off and shut down by using SAS (The GINA monitors devices for SAS events).<ol><li>The GINA calls the <a href="/windows/desktop/api/winwlx/nc-winwlx-pwlx_sas_notify">WlxSasNotify</a> function.</li><li>Winlogon calls the GINA's <a href="/windows/desktop/api/Winwlx/nf-winwlx-wlxloggedonsas">WlxLoggedOnSAS</a> function.</li><li>The GINA returns WLX_SAS_ACTION_SHUTDOWN.</li><li>Winlogon calls the GINA's <a href="/windows/desktop/api/Winwlx/nf-winwlx-wlxlogoff">WlxLogoff</a> function.</li><li>Winlogon calls the GINA's <a href="/windows/desktop/api/Winwlx/nf-winwlx-wlxshutdown">WlxShutdown</a> function.</li></ol>

Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.

资料来源与适用范围

资料来源
Microsoft Learn / Windows Win32 documentation
适用范围
Windows Win32 API · Source date 05/31/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0 (documentation), MIT (code samples)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。