Función WlxLoggedOnSAS (winwlx.h)
[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.
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 |
|---|---|
|
Indica que no se recibió ninguna entrada del usuario dentro del período de tiempo de espera especificado. |
|
Indica que un usuario ha escrito la secuencia de atención segura (SAS) ESTÁNDAR CTRL+ALT+SUPR. |
|
Indica que se ha insertado una tarjeta inteligente en un dispositivo compatible. |
|
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 |
|---|---|
|
Devuelve al escritorio predeterminado. |
|
Bloquea la estación de trabajo y espera a la siguiente SAS. |
|
Cierra la sesión del usuario en la estación de trabajo. |
|
Cierra el usuario y apaga el equipo. |
|
Cierra el usuario, apaga el equipo y, a continuación, reinicia el equipo. |
|
Si el hardware lo permite, cierra el usuario, apaga el equipo y, a continuación, desactiva el equipo. |
|
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. |
|
Invoca la lista de tareas. |
|
Cierra la sesión forzada del usuario. |
|
Coloca el equipo en modo de suspensión. |
|
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. |
|
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 |