Fungsi GetThreadDesktop (winuser.h)

Artikel
03/04/2024

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)