winwlx.h header
This header is used by Security and Identity. For more information, see:
winwlx.h contains the following programming interfaces:
Functions
| WlxActivateUserShell Activates the user shell program. |
| WlxDisconnectNotify Winlogon calls this function when a Terminal Services network session is disconnected. |
| WlxDisplayLockedNotice Allows the GINA to display information about the lock, such as who locked the workstation and when it was locked. |
| WlxDisplaySASNotice Winlogon calls this function when no user is logged on. |
| WlxDisplayStatusMessage Winlogon calls this function when the GINA DLL should display a message. |
| WlxGetConsoleSwitchCredentials Winlogon calls this function to read the currently logged on user's credentials to transparently transfer them to a target session. |
| WlxGetStatusMessage Winlogon calls this function to get the status message being displayed by the GINA DLL. |
| WlxInitialize Winlogon calls this function once for each window station present on the computer. Currently, the operating system supports one window station per workstation. |
| WlxIsLockOk Winlogon calls this function before attempting to lock the workstation. |
| WlxIsLogoffOk Winlogon calls this function when the user initiates a logoff operation. |
| WlxLoggedOnSAS Winlogon calls this function when it receives a secure attention sequence (SAS) event while the user is logged on and the workstation is not locked. |
| WlxLoggedOutSAS Winlogon calls this function when it receives a secure attention sequence (SAS) event while no user is logged on. |
| WlxLogoff Winlogon calls this function to notify the GINA of a logoff operation on this workstation, allowing the GINA to perform any logoff operations that may be required. |
| WlxNegotiate The WlxNegotiate function must be implemented by a replacement GINA DLL. This is the first call made by Winlogon to the GINA DLL. WlxNegotiate allows the GINA to verify that it supports the installed version of Winlogon. |
| WlxNetworkProviderLoad Winlogon calls this function to collect valid authentication and identification information. |
| WlxReconnectNotify Winlogon calls this function when a Terminal Services network session is reconnected. |
| WlxRemoveStatusMessage Winlogon calls this function to tell the GINA DLL to stop displaying the status message. |
| WlxScreenSaverNotify Winlogon calls this function immediately before a screen saver is activated, allowing the GINA to interact with the screen saver program. |
| WlxShutdown Winlogon calls this function just before shutting down, allowing the GINA to perform any shutdown tasks, such as ejecting a smart card from a reader. |
| WlxStartApplication Winlogon calls this function when the system needs an application to be started in the context of the user. |
| WlxWkstaLockedSAS Winlogon calls this function when it receives a secure attention sequence (SAS) and the workstation is locked. |
Callback functions
| PWLX_ASSIGN_SHELL_PROTECTION Called by GINA to assign protection to the shell program of a newly logged-on user. |
| PWLX_CHANGE_PASSWORD_NOTIFY Called by GINA to indicate it has changed a password. |
| PWLX_CHANGE_PASSWORD_NOTIFY_EX Called by GINA to tell a specific network provider (or all network providers) that a password has changed. |
| PWLX_CLOSE_USER_DESKTOP Called by GINA to close an alternate user desktop and clean up after the desktop is closed. |
| PWLX_CREATE_USER_DESKTOP Called by GINA to create alternate application desktops for the user. |
| PWLX_DIALOG_BOX Called by the GINA to create a modal dialog box from a dialog box template. |
| PWLX_DIALOG_BOX_INDIRECT Called by GINA to create a modal dialog box from a dialog box template in memory. |
| PWLX_DIALOG_BOX_INDIRECT_PARAM Called by GINA to initialize dialog box controls and then create a modal dialog box from a dialog box template in memory. |
| PWLX_DIALOG_BOX_PARAM Called by GINA to initialize dialog box controls and then create a modal dialog box from a dialog box template resource. |
| PWLX_DISCONNECT Called by a replacement GINA DLL if Terminal Services is enabled. GINA calls this function to disconnect from a Terminal Services network session. |
| PWLX_GET_OPTION Called by GINA to retrieve the current value of an option. |
| PWLX_GET_SOURCE_DESKTOP Called by GINA to determine the name and handle of the desktop that was current before Winlogon switched to the Winlogon desktop. |
| PWLX_MESSAGE_BOX Called by GINA to create, display, and operate a message box. |
| PWLX_QUERY_CLIENT_CREDENTIALS Called by a replacement GINA DLL if Terminal Services is enabled. GINA calls this function to retrieve the credentials of remote Terminal Services clients that are not using an Internet connector license. |
| PWLX_QUERY_CONSOLESWITCH_CREDENTIALS Called by GINA to read the credentials transferred from the Winlogon of the temporary session to the Winlogon of the destination session. |
| PWLX_QUERY_IC_CREDENTIALS Called by a replacement GINA DLL if Terminal Services is enabled. GINA calls this function to determine whether the terminal server is using Internet connector licensing and to retrieve credentials information. |
| PWLX_QUERY_TERMINAL_SERVICES_DATA Called by GINA to retrieve Terminal Services user configuration information after a user has logged on. |
| PWLX_QUERY_TS_LOGON_CREDENTIALS Called by a replacement GINA DLL to retrieve credentials information if Terminal Services is enabled. The GINA DLL can then use this information to fill in a logon box automatically and attempt to log the user in. |
| PWLX_SAS_NOTIFY Called by GINA to notify Winlogon of a secure attention sequence (SAS) event. |
| PWLX_SET_CONTEXT_POINTER Called by GINA to specify the context pointer passed by Winlogon as the first parameter to all future calls to GINA functions. |
| PWLX_SET_OPTION Called by GINA to set the value of an option. |
| PWLX_SET_RETURN_DESKTOP Called by GINA to specify the alternate application desktop that Winlogon will switch to when the current secure attention sequence (SAS) event processing function is complete. |
| PWLX_SET_TIMEOUT Called by GINA to change the time-out associated with a dialog box. The default time-out is two minutes. |
| PWLX_SWITCH_DESKTOP_TO_USER Called by GINA to switch to the application desktop. |
| PWLX_SWITCH_DESKTOP_TO_WINLOGON Allows the GINA DLL switch to the Winlogon desktop. |
| PWLX_USE_CTRL_ALT_DEL Called by GINA to tell Winlogon to use the standard CTRL+ALT+DEL key combination as a secure attention sequence (SAS). |
| PWLX_WIN31_MIGRATE Called by a replacement GINA DLL if Terminal Services is enabled. GINA calls this function to complete the setup of the Terminal Services client. |
Structures
| WLX_CLIENT_CREDENTIALS_INFO_V1_0 Contains the client credentials returned by a call to WlxQueryClientCredentials or WlxQueryInetConnectorCredentials. |
| WLX_CLIENT_CREDENTIALS_INFO_V2_0 Contains the client credentials returned by a call to WlxQueryTsLogonCredentials. |
| WLX_CONSOLESWITCH_CREDENTIALS_INFO_V1_0 Contains the client credentials returned by a call to WlxGetConsoleSwitchCredentials. |
| WLX_DESKTOP Used to pass desktop information between your GINA DLL and Winlogon. |
| WLX_DISPATCH_VERSION_1_0 Defines the format of the Winlogon version 1.0 function dispatch table passed to your GINA DLL in the WlxInitialize call. |
| WLX_DISPATCH_VERSION_1_1 Defines the format of the Winlogon version 1.1 function dispatch passed to your GINA DLL in the WlxInitialize call. |
| WLX_DISPATCH_VERSION_1_2 Defines the format of the Winlogon version 1.2 function dispatch table passed to your GINA DLL in the WlxInitialize call. |
| WLX_DISPATCH_VERSION_1_3 Defines the format of the Winlogon version 1.3 function dispatch table passed to your GINA DLL in the WlxInitialize call. |
| WLX_DISPATCH_VERSION_1_4 Defines the format of the Winlogon version 1.4 function dispatch table passed to the GINA DLL in the WlxInitialize call. |
| WLX_MPR_NOTIFY_INFO Provides identification and authentication information to network providers. |
| WLX_NOTIFICATION_INFO This structure stores information about a Winlogon event. |
| WLX_PROFILE_V1_0 Contains information used for setting up the initial environment. |
| WLX_PROFILE_V2_0 Contains profile information in addition to the information provided by WLX_PROFILE_V1_0. |
| WLX_TERMINAL_SERVICES_DATA Used to provide GINA with Terminal Services user configuration information. |