Função WlxWkstaLockedSAS (winwlx.h)

  • Artigo

A função WlxWkstaLockedSAS deve ser implementada por uma DLL GINA de substituição. O Winlogon chama essa função quando recebe uma SAS ( sequência de atenção segura ) e a estação de trabalho está bloqueada. O GINA deve retornar um valor que indica que a estação de trabalho deve permanecer bloqueada, a estação de trabalho deve ser desbloqueada ou o usuário conectado deve ser conectado (o que deixa a estação de trabalho bloqueada até que o logoff seja concluído).

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

Sintaxe

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

Parâmetros

[in] pWlxContext

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

[in] dwSasType

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

Os seguintes tipos de SAS são predefinidos.

Valor Significado
WLX_SAS_TYPE_CTRL_ALT_DEL
 Indica que um usuário digitou a SAS ( sequência de atenção segura ) CTRL+ALT+DEL padrão.
WLX_SAS_TYPE_SC_INSERT
 Indica que uma cartão inteligente foi inserida em um dispositivo compatível.
WLX_SAS_TYPE_SC_REMOVE
 Indica que uma cartão inteligente foi removida de um dispositivo compatível.
WLX_SAS_TYPE_TIMEOUT
 Indica que nenhuma entrada de usuário foi recebida dentro do período de tempo limite especificado.

Retornar valor

A função WlxWkstaLockedSAS deve retornar os valores a seguir.

Código de retorno Descrição
WLX_SAS_ACTION_NONE
 Informa ao Winlogon para manter a estação de trabalho bloqueada.
WLX_SAS_ACTION_FORCE_LOGOFF
 Informa ao Winlogon para desconectar o usuário à força.
WLX_SAS_ACTION_LOGOFF
 Informa ao Winlogon para desconectar o usuário atual.
WLX_SAS_ACTION_UNLOCK_WKSTA
 Informa ao Winlogon para desbloquear a estação de trabalho.

Comentários

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