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) |