Función WlxLoggedOnSAS (winwlx.h)

  • Artículo

[La función WlxLoggedOnSAS ya no está disponible para su uso a partir de Windows Server 2008 y Windows Vista.]

La función WlxLoggedOnSAS debe implementarse mediante un archivo DLL de GINA de reemplazo. Winlogon llama a esta función cuando recibe un evento de secuencia de atención segura (SAS) mientras el usuario ha iniciado sesión y la estación de trabajo no está bloqueada.

Nota Los archivos DLL de GINA se omiten en Windows Vista.
 

Sintaxis

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

Parámetros

[in] pWlxContext

Puntero al contexto de GINA asociado a esta estación de ventana. GINA devuelve este valor de contexto cuando Winlogon llama a WlxInitialize para esta estación.

[in] dwSasType

Especifica el tipo de SAS que se ha producido. Los valores de cero a WLX_SAS_TYPE_MAX_MSFT_VALUE están reservados para definir tipos estándar de SAS de Microsoft. Los desarrolladores de GINA pueden definir tipos de SAS adicionales mediante valores mayores que WLX_SAS_TYPE_MAX_MSFT_VALUE.

Los siguientes tipos de SAS están predefinidos.

Value Significado
WLX_SAS_TYPE_TIMEOUT
0 (0x0)
 Indica que no se recibió ninguna entrada del usuario dentro del período de tiempo de espera especificado.
WLX_SAS_TYPE_CTRL_ALT_DEL
1 (0x1)
 Indica que un usuario ha escrito la secuencia de atención segura (SAS) ESTÁNDAR CTRL+ALT+SUPR.
WLX_SAS_TYPE_SC_INSERT
5 (0x5)
 Indica que se ha insertado una tarjeta inteligente en un dispositivo compatible.
WLX_SAS_TYPE_SC_REMOVE
6 (0x6)
 Indica que se ha quitado una tarjeta inteligente de un dispositivo compatible.

[in] pReserved

Este parámetro está reservado y debe establecerse en NULL.

Valor devuelto

La función WlxLoggedOnSAS debe devolver uno de los valores siguientes.

Código devuelto Descripción
WLX_SAS_ACTION_NONE
 Devuelve al escritorio predeterminado.
WLX_SAS_ACTION_LOCK_WKSTA
 Bloquea la estación de trabajo y espera a la siguiente SAS.
WLX_SAS_ACTION_LOGOFF
 Cierra la sesión del usuario en la estación de trabajo.
WLX_SAS_ACTION_SHUTDOWN
 Cierra el usuario y apaga el equipo.
WLX_SAS_ACTION_SHUTDOWN_REBOOT
 Cierra el usuario, apaga el equipo y, a continuación, reinicia el equipo.
WLX_SAS_ACTION_SHUTDOWN_POWER_OFF
 Si el hardware lo permite, cierra el usuario, apaga el equipo y, a continuación, desactiva el equipo.
WLX_SAS_ACTION_PWD_CHANGED
 Notifica a los proveedores de red que el usuario cambió su contraseña. Los archivos DLL de GINA obsoletos deben llamar a WlxChangePasswordNotify cada vez que se cambia una contraseña.
WLX_SAS_ACTION_TASKLIST
 Invoca la lista de tareas.
WLX_SAS_ACTION_FORCE_LOGOFF
 Cierra la sesión forzada del usuario.
WLX_SAS_ACTION_SHUTDOWN_SLEEP
 Coloca el equipo en modo de suspensión.
WLX_SAS_ACTION_SHUTDOWN_SLEEP2
 Apaga el sistema en un estado de alimentación ACPI. Si el equipo no es un equipo ACPI, esta opción no tendrá ningún efecto.
WLX_SAS_ACTION_SHUTDOWN_HIBERNATE
 Apaga el sistema en modo de hibernación. Si el sistema no se configuró para la hibernación, esta opción no tendrá ningún efecto.

Observaciones

Winlogon llama a WlxLoggedOnSAS cuando el usuario que ha iniciado sesión quiere apagar, cerrar sesión o bloquear la estación de trabajo. El archivo DLL de GINA puede bloquear la estación de trabajo devolviendo WLX_SAS_ACTION_LOCK_WKSTA. Cuando se devuelve este valor, Winlogon bloquea la estación de trabajo y llama a WlxWkstaLockedSAS la próxima vez que reciba una SAS.

Antes de llamar a WlxLoggedOnSAS, Winlogon establece el estado de escritorio para que el escritorio actual sea el escritorio de Winlogon y establezca el estado de la estación de trabajo para que el escritorio esté bloqueado.

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winwlx.h

Consulte también

WlxInitialize

WlxWkstaLockedSAS