Função WlxWkstaLockedSAS (winwlx.h)

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