Função WlxLoggedOnSAS (winwlx.h)

  • Artigo

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

A função WlxLoggedOnSAS deve ser implementada por uma DLL GINA de substituição. O Winlogon chama essa função quando recebe um evento SAS (sequência de atenção segura) enquanto o usuário está conectado e a estação de trabalho não está bloqueada.

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

Sintaxe

int WlxLoggedOnSAS(
  [in] PVOID pWlxContext,
  [in] DWORD dwSasType,
  [in] PVOID pReserved
);

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] dwSasType

Especifica o tipo de SAS que ocorreu. Valores de zero a WLX_SAS_TYPE_MAX_MSFT_VALUE são reservados para definir tipos padrão de SAS da Microsoft. Os desenvolvedores gina podem definir tipos sas adicionais usando valores maiores que WLX_SAS_TYPE_MAX_MSFT_VALUE.

Os tipos sas a seguir são predefinidos.

Valor Significado
WLX_SAS_TYPE_TIMEOUT
0 (0x0)
 Indica que nenhuma entrada do usuário foi recebida dentro do período de tempo limite especificado.
WLX_SAS_TYPE_CTRL_ALT_DEL
1 (0x1)
 Indica que um usuário digitou a SAS (sequência de atenção segura ) CTRL+ALT+DEL padrão.
WLX_SAS_TYPE_SC_INSERT
5 (0x5)
 Indica que um cartão inteligente foi inserido em um dispositivo compatível.
WLX_SAS_TYPE_SC_REMOVE
6 (0x6)
 Indica que um cartão inteligente foi removido de um dispositivo compatível.

[in] pReserved

Esse parâmetro é reservado e deve ser definido como NULL.

Valor retornado

A função WlxLoggedOnSAS deve retornar um dos valores a seguir.

Código de retorno Descrição
WLX_SAS_ACTION_NONE
 Retorna para a área de trabalho padrão.
WLX_SAS_ACTION_LOCK_WKSTA
 Bloqueia a estação de trabalho e aguarda a próxima SAS.
WLX_SAS_ACTION_LOGOFF
 Registra o usuário fora da estação de trabalho.
WLX_SAS_ACTION_SHUTDOWN
 Registra o usuário desativado e desliga o computador.
WLX_SAS_ACTION_SHUTDOWN_REBOOT
 Registra o usuário desativado, desliga o computador e reinicia o computador.
WLX_SAS_ACTION_SHUTDOWN_POWER_OFF
 Se o hardware permitir, o logoff do usuário, desligará o computador e desligará o computador.
WLX_SAS_ACTION_PWD_CHANGED
 Notifica os provedores de rede de que o usuário alterou sua senha. DLLs GINA obsoletas devem chamar WlxChangePasswordNotify sempre que uma senha for alterada.
WLX_SAS_ACTION_TASKLIST
 Invoca a lista de tarefas.
WLX_SAS_ACTION_FORCE_LOGOFF
 Faz logoff à força do usuário.
WLX_SAS_ACTION_SHUTDOWN_SLEEP
 Coloca o computador no modo de suspensão.
WLX_SAS_ACTION_SHUTDOWN_SLEEP2
 Desliga o sistema em um estado de desligamento de ACPI. Se o computador não for um computador ACPI, essa opção não terá efeito.
WLX_SAS_ACTION_SHUTDOWN_HIBERNATE
 Desliga o sistema no modo de hibernação. Se o sistema não tiver sido configurado para hibernação, essa opção não terá efeito.

Comentários

O Winlogon chama WlxLoggedOnSAS quando o usuário conectado deseja desligar, fazer logoff ou bloquear a estação de trabalho. A DLL gina pode bloquear a estação de trabalho retornando WLX_SAS_ACTION_LOCK_WKSTA. Quando esse valor é retornado, o Winlogon bloqueia a estação de trabalho e chama WlxWkstaLockedSAS na próxima vez que receber uma SAS.

Antes de chamar WlxLoggedOnSAS, 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

   
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

WlxWkstaLockedSAS