Fungsi GetThreadDesktop (winuser.h)
Mengambil handel ke desktop yang ditetapkan ke utas yang ditentukan.
Sintaks
HDESK GetThreadDesktop(
[in] DWORD dwThreadId
);
Parameter
[in] dwThreadId
Pengidentifikasi utas. Fungsi GetCurrentThreadId dan CreateProcess mengembalikan pengidentifikasi utas.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke desktop yang terkait dengan utas yang ditentukan. Anda tidak perlu memanggil fungsi CloseDesktop untuk menutup handel yang dikembalikan.
Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Sistem mengaitkan desktop dengan utas saat utas tersebut dibuat. Utas dapat menggunakan fungsi SetThreadDesktop untuk mengubah desktopnya. Desktop yang terkait dengan utas harus berada di stasiun jendela yang terkait dengan proses utas.
Proses panggilan dapat menggunakan handel yang dikembalikan dalam panggilan ke fungsi GetUserObjectInformation, GetUserObjectSecurity, SetUserObjectInformation, dan SetUserObjectSecurity .
Aplikasi layanan dibuat dengan stasiun jendela dan desktop terkait, sehingga tidak perlu memanggil fungsi USER atau GDI untuk menghubungkan layanan ke stasiun jendela dan desktop.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
Target Platform | Windows |
Header | winuser.h (termasuk Windows.h) |
Pustaka | User32.lib |
DLL | User32.dll |
Set API | ext-ms-win-ntuser-windowstation-l1-1-0 (diperkenalkan dalam Windows 8) |