Função WlxScreenSaverNotify (winwlx.h)

[A função WlxScreenSaverNotify não está mais disponível para uso desde o Windows Server 2008 e o Windows Vista.]

A função WlxScreenSaverNotify pode ser implementada por uma DLL GINA de substituição. O Winlogon chama essa função imediatamente antes que um protetor de tela seja ativado, permitindo que a GINA interaja com o programa de salvamento de tela.

Nota As DLLs GINA são ignoradas no Windows Vista.

 

Sintaxe

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

Parâmetros

[in] pWlxContext

Um ponteiro para o contexto gina associado a esta estação de janela. A GINA retorna esse valor de contexto quando Winlogon chama WlxInitialize para esta estação.

[in, out] pSecure

Um ponteiro para um valor booliano que, na entrada, especifica se o protetor de tela atual é seguro e,

na saída, indica se a estação de trabalho deve ser bloqueada.

Retornar valor

Se o protetor de tela precisar ser ativado, a função retornará TRUE.

Se o protetor de tela não deve ser ativado, a função retorna FALSE.

Comentários

Se a DLL gina não exportar essa função, o Winlogon usará o comportamento padrão a seguir.

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

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

Antes de chamar WlxScreenSaverNotify, o Winlogon define o estado da área de trabalho para que a área de trabalho atual seja a área de trabalho do Winlogon e defina o estado da estação de trabalho para que a área de trabalho seja bloqueada.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winwlx.h

Confira também

WlxInitialize