Export (0) Print
Expand All
Expand Minimize

WlxScreenSaverNotify function

[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.

Note   GINA DLLs are ignored in Windows Vista.

Syntax


BOOL WlxScreenSaverNotify(
  _In_     PVOID pWlxContext,
  _Inout_  BOOL *pSecure
);

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.

pSecure [in, out]

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

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

Winwlx.h

See also

WlxInitialize

 

 

Community Additions

ADD
Show:
© 2015 Microsoft