Partager via


SwitchDesktop, fonction (winuser.h)

Rend le bureau spécifié visible et l’active. Cela permet au bureau de recevoir des entrées de l’utilisateur. Le processus d’appel doit avoir DESKTOP_SWITCHDESKTOP accès au bureau pour que la fonction SwitchDesktop réussisse.

Syntaxe

BOOL SwitchDesktop(
  [in] HDESK hDesktop
);

Paramètres

[in] hDesktop

Handle sur le bureau. Ce handle est retourné par les fonctions CreateDesktop et OpenDesktop .

Ce bureau doit être associé à la station de fenêtre actuelle pour le processus.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError. Toutefois, SwitchDesktop définit uniquement la dernière erreur pour les cas suivants :

  • Quand le bureau appartient à une station de fenêtre invisible
  • Lorsque hDesktop n’est pas un handle non valide, fait référence à un bureau détruit ou appartient à une session différente de celle du processus appelant

Remarques

La fonction SwitchDesktop échoue si le bureau appartient à une station de fenêtre invisible. SwitchDesktop échoue également lorsqu’il est appelé à partir d’un processus associé à un bureau sécurisé tel que les bureaux WinLogon et ScreenSaver. Les processus associés à un bureau sécurisé incluent des processus UserInit personnalisés. Ces appels échouent généralement avec une erreur « accès refusé ».

Spécifications

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
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-windowstation-l1-1-0 (introduit dans Windows 8)

Voir aussi

CreateDesktop

Bureaux

OpenDesktop

Window Station et fonctions de bureau