Partager via


SetThreadDesktop, fonction (winuser.h)

Affecte le bureau spécifié au thread appelant. Toutes les opérations suivantes sur le bureau utilisent les droits d’accès accordés au bureau.

Syntaxe

BOOL SetThreadDesktop(
  [in] HDESK hDesktop
);

Paramètres

[in] hDesktop

Handle au bureau à affecter au thread appelant. Ce handle est retourné par la fonction CreateDesktop, GetThreadDesktop, OpenDesktop ou OpenInputDesktop .

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.

Remarques

La fonction SetThreadDesktop échoue si le thread appelant a des fenêtres ou des hooks sur son bureau actuel (sauf si le paramètre hDesktop est un handle pour le bureau actuel).

Avertissement Il existe un risque de sécurité important pour tout service qui ouvre une fenêtre sur le bureau interactif. En ouvrant une fenêtre de bureau, un service se rend vulnérable aux attaques de l’utilisateur connecté, dont l’application peut envoyer des messages malveillants à la fenêtre de bureau du service et affecter sa capacité à fonctionner.
 

Configuration requise

Condition requise Valeur
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

GetThreadDesktop

OpenDesktop

SetProcessWindowStation

Window Station et fonctions de bureau