WlxScreenSaverNotify-Funktion (winwlx.h)

Artikel
03/13/2024

[Die WlxScreenSaverNotify-Funktion ist ab Windows Server 2008 und Windows Vista nicht mehr verfügbar.]

Die WlxScreenSaverNotify-Funktion kann von einer GINA-Ersatz-DLL implementiert werden. Winlogon ruft diese Funktion unmittelbar vor dem Aktivieren eines Bildschirmschoner auf, sodass die GINA mit dem Bildschirmschonerprogramm interagieren kann.

Hinweis GINA-DLLs werden in Windows Vista ignoriert.

Syntax

BOOL WlxScreenSaverNotify(
  [in]      PVOID pWlxContext,
  [in, out] BOOL  *pSecure
);

Parameter

[in] pWlxContext

Ein Zeiger auf den GINA-Kontext , der dieser Fensterstation zugeordnet ist. Die GINA gibt diesen Kontextwert zurück, wenn Winlogon WlxInitialize für diese Station aufruft.

[in, out] pSecure

Ein Zeiger auf einen booleschen Wert, der bei der Eingabe angibt, ob der aktuelle Bildschirmschoner sicher ist, und

gibt an, ob die Arbeitsstation gesperrt werden soll.

Rückgabewert

Wenn der Bildschirmschoner aktiviert werden soll, gibt die Funktion TRUE zurück.

Wenn der Bildschirmschoner nicht aktiviert werden soll, gibt die Funktion FALSE zurück.

Hinweise

Wenn Ihre GINA-DLL diese Funktion nicht exportiert, verwendet Winlogon das folgende Standardverhalten.

#include <windows.h>
#include <Winwlx.h>

BOOL DefaultScreenSaverNotify(
   PVOID   pWlxContext,
   BOOL    *pSecure)
{
  if (*pSecure)
  {
    *pSecure = WlxIsLockOk(pWlxContext);
  }
  return(TRUE);
}

Vor dem Aufrufen von WlxScreenSaverNotify legt Winlogon den Desktopstatus so fest, dass der aktuelle Desktop der Winlogon-Desktop ist, und legt den Arbeitsstationsstatus so fest, dass der Desktop gesperrt ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winwlx.h

Weitere Informationen

WlxInitialize