SetThreadDesktop, fonction (winuser.h)

Article
2024-03-04

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

C++

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)