Edit

Share via


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.