LockWorkStation, fonction (winuser.h)

Verrouille l’affichage de la station de travail. Le verrouillage d’une station de travail la protège contre toute utilisation non autorisée.

Syntaxe

BOOL LockWorkStation();

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro. Étant donné que la fonction s’exécute de manière asynchrone, une valeur de retour différente de zéro indique que l’opération a été lancée. Elle n’indique pas si la station de travail a été correctement verrouillée.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

La fonction LockWorkStation n’est appelante que par les processus en cours d’exécution sur le bureau interactif. En outre, l’utilisateur doit être connecté et la station de travail ne peut pas déjà être verrouillée.

Les raisons courantes pour lesquelles la station de travail peut ne pas être verrouillée, même si la fonction réussit, sont les suivantes : aucun utilisateur n’est connecté, la station de travail est déjà verrouillée, le processus n’est pas en cours d’exécution sur le bureau interactif ou la demande est refusée par la DLL D’identification graphique et d’authentification (GINA).

Cette fonction a le même résultat que d’appuyer sur Ctrl+Alt+Suppr et de cliquer sur Verrouiller. Pour déverrouiller la station de travail, l’utilisateur doit se connecter. Il n’existe aucune fonction que vous pouvez appeler pour déterminer si la station de travail est verrouillée. Pour recevoir une notification lorsque l’utilisateur verrouille la station de travail ou se connecte, utilisez la fonction WTSRegisterSessionNotification pour recevoir WM_WTSSESSION_CHANGE messages. Vous pouvez utiliser les notifications de session pour suivre l’état du bureau afin de savoir s’il est possible d’interagir avec l’utilisateur.

Exemples

Pour obtenir un exemple, consultez Comment verrouiller la station de travail.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau | applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau | applications UWP]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-misc-l1-5-1 (introduit dans Windows 10, version 10.0.14393)

Voir aussi

Fonctions d’arrêt du système