Partager via


GetThreadDesktop, fonction (winuser.h)

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)

Voir aussi

Bureaux

GetCurrentThreadId

GetProcessWindowStation

GetUserObjectInformation

GetUserObjectSecurity

SetProcessWindowStation

SetThreadDesktop

SetUserObjectInformation

SetUserObjectSecurity

Window Station et fonctions de bureau