WlxScreenSaverNotify function (winwlx.h)
[The WlxScreenSaverNotify function is no longer available for use as of Windows Server 2008 and Windows Vista.]
The WlxScreenSaverNotify function may be implemented by a replacement GINA DLL. Winlogon calls this function immediately before a screen saver is activated, allowing the GINA to interact with the screen saver program.
Syntax
BOOL WlxScreenSaverNotify(
[in] PVOID pWlxContext,
[in, out] BOOL *pSecure
);
Parameters
[in] pWlxContext
A pointer to the GINA context associated with this window station. The GINA returns this context value when Winlogon calls WlxInitialize for this station.
[in, out] pSecure
A pointer to a Boolean value that, on input, specifies whether the current screen saver is secure and,
on output, indicates whether the workstation should be locked.
Return value
If the screen saver should be activated, the function returns TRUE.
If the screen saver should not be activated, the function returns FALSE.
Remarks
If your GINA DLL does not export this function, Winlogon uses the following default behavior.
#include <windows.h>
#include <Winwlx.h>
BOOL DefaultScreenSaverNotify(
PVOID pWlxContext,
BOOL *pSecure)
{
if (*pSecure)
{
*pSecure = WlxIsLockOk(pWlxContext);
}
return(TRUE);
}
Before calling WlxScreenSaverNotify, 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
Requirement | Value |
---|---|
Minimum supported client | Windows XP [desktop apps only] |
Minimum supported server | Windows Server 2003 [desktop apps only] |
Target Platform | Windows |
Header | winwlx.h |