GetThreadDesktop, fonction (winuser.h)

Article
03/04/2024

Récupère un handle sur le bureau affecté au thread spécifié.

Syntaxe

HDESK GetThreadDesktop(
  [in] DWORD dwThreadId
);

Paramètres

[in] dwThreadId

Identificateur du thread. Les fonctions GetCurrentThreadId et CreateProcess retournent des identificateurs de thread.

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle pour le bureau associé au thread spécifié. Vous n’avez pas besoin d’appeler la fonction CloseDesktop pour fermer le handle retourné.

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

Remarques

Le système associe un bureau à un thread lors de la création de ce thread. Un thread peut utiliser la fonction SetThreadDesktop pour modifier son bureau. Le bureau associé à un thread doit se trouver sur la station de fenêtre associée au processus du thread.

Le processus d’appel peut utiliser le handle retourné dans les appels aux fonctions GetUserObjectInformation, GetUserObjectSecurity, SetUserObjectInformation et SetUserObjectSecurity .

Une application de service est créée avec une station de fenêtre et un bureau associés, il n’est donc pas nécessaire d’appeler une fonction USER ou GDI pour connecter le service à une station de fenêtre et à un bureau.

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)