WlxWkstaLockedSAS function
The WlxWkstaLockedSAS function must be implemented by a replacement GINA DLL. Winlogon calls this function when it receives a secure attention sequence (SAS) and the workstation is locked. The GINA should return a value that indicates the workstation is to remain locked, the workstation is to be unlocked, or the logged-on user is to be logged off (which leaves the workstation locked until the logoff is completed).
Syntax
int WlxWkstaLockedSAS(
_In_ PVOID pWlxContext,
_In_ DWORD dwSasType
);
Parameters
- pWlxContext [in]
-
A pointer to the GINA context associated with this window station. The GINA returns this context value when Winlogon calls WlxInitialize for this station.
- dwSasType [in]
-
Specifies the type of SAS that occurred. Values from zero to WLX_SAS_TYPE_MAX_MSFT_VALUE are reserved for standard Microsoft SAS types. GINA developers can use values greater than WLX_SAS_TYPE_MAX_MSFT_VALUE to define additional SAS types.
The following SAS types are predefined.
Value Meaning - WLX_SAS_TYPE_CTRL_ALT_DEL
Indicates a user has typed the standard CTRL+ALT+DEL secure attention sequence (SAS).
- WLX_SAS_TYPE_SC_INSERT
Indicates that a smart card has been inserted into a compatible device.
- WLX_SAS_TYPE_SC_REMOVE
Indicates that a smart card has been removed from a compatible device.
- WLX_SAS_TYPE_TIMEOUT
Indicates that no user input was received within the specified time-out period.
Return value
The WlxWkstaLockedSAS function should return the following values.
| Return code | Description |
|---|---|
|
Tells Winlogon to keep the workstation locked. |
|
Tells Winlogon to forcibly log the user off. |
|
Tells Winlogon to log the current user off. |
|
Tells Winlogon to unlock the workstation. |
Remarks
Before calling WlxWkstaLockedSAS, Winlogon sets the desktop state so that the current desktop is the Winlogon desktop and sets the workstation state so that the desktop is locked.
Requirements
|
Minimum supported client |
Windows XP [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2003 [desktop apps only] |
|
End of client support |
Windows XP |
|
End of server support |
Windows Server 2003 |
|
Header |
|
See also