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.
