Función LockWorkStation (winuser.h)

Bloquea la pantalla de la estación de trabajo. El bloqueo de una estación de trabajo lo protege del uso no autorizado.

Sintaxis

BOOL LockWorkStation();

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero. Dado que la función se ejecuta de forma asincrónica, un valor devuelto distinto de cero indica que se ha iniciado la operación. No indica si la estación de trabajo se ha bloqueado correctamente.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

La función LockWorkStation solo se puede llamar mediante procesos que se ejecutan en el escritorio interactivo. Además, el usuario debe iniciar sesión y la estación de trabajo no puede estar bloqueada.

Es posible que la estación de trabajo no esté bloqueada incluso si la función se realiza correctamente incluye lo siguiente: no hay ningún usuario conectado, la estación de trabajo ya está bloqueada, el proceso no se está ejecutando en el escritorio interactivo o la solicitud se deniega mediante la DLL de identificación y autenticación gráfica (GINA).

Esta función tiene el mismo resultado que presionar Ctrl+Alt+Supr y hacer clic en Bloquear. Para desbloquear la estación de trabajo, el usuario debe iniciar sesión. No hay ninguna función a la que se pueda llamar para determinar si la estación de trabajo está bloqueada. Para recibir una notificación cuando el usuario bloquee la estación de trabajo o inicie sesión, use la función WTSRegisterSessionNotification para recibir mensajes WM_WTSSESSION_CHANGE . Puede usar notificaciones de sesión para realizar un seguimiento del estado del escritorio para saber si es posible interactuar con el usuario.

Ejemplos

Para obtener un ejemplo, vea Cómo bloquear la estación de trabajo.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado winuser.h (incluir Windows.h)
Library User32.lib
Archivo DLL User32.dll
Conjunto de API ext-ms-win-ntuser-misc-l1-5-1 (introducido en Windows 10, versión 10.0.14393)

Consulte también

Funciones de apagado del sistema