WlxScreenSaverNotify, fonction (winwlx.h)

Article
03/04/2024

[La fonction WlxScreenSaverNotify n’est plus disponible à partir de Windows Server 2008 et Windows Vista.]

La fonction WlxScreenSaverNotify peut être implémentée par une DLL GINA de remplacement. Winlogon appelle cette fonction immédiatement avant l’activation d’un économiseur d’écran, ce qui permet au GINA d’interagir avec le programme d’économiseur d’écran.

Note Les DLL GINA sont ignorées dans Windows Vista.

Syntaxe

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

Paramètres

[in] pWlxContext

Pointeur vers le contexte GINA associé à cette station de fenêtre. Le GINA retourne cette valeur de contexte lorsque Winlogon appelle WlxInitialize pour cette station.

[in, out] pSecure

Pointeur vers une valeur booléenne qui, en entrée, spécifie si l’économiseur d’écran actuel est sécurisé et,

sur la sortie, indique si la station de travail doit être verrouillée.

Valeur retournée

Si l’économiseur d’écran doit être activé, la fonction retourne TRUE.

Si l’économiseur d’écran ne doit pas être activé, la fonction retourne FALSE.

Remarques

Si votre DLL GINA n’exporte pas cette fonction, Winlogon utilise le comportement par défaut suivant.

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

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

Avant d’appeler WlxScreenSaverNotify, Winlogon définit l’état du bureau afin que le bureau actuel soit le bureau Winlogon et définit l’état de la station de travail afin que le bureau soit verrouillé.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winwlx.h

Voir aussi

WlxInitialize

Partager via