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) |