Fungsi SetThreadDesktop (winuser.h)
Menetapkan desktop yang ditentukan ke utas panggilan. Semua operasi berikutnya di desktop menggunakan hak akses yang diberikan ke desktop.
Sintaks
BOOL SetThreadDesktop(
[in] HDESK hDesktop
);
Parameter
[in] hDesktop
Handel ke desktop yang akan ditetapkan ke utas panggilan. Handel ini dikembalikan oleh fungsi CreateDesktop, GetThreadDesktop, OpenDesktop, atau OpenInputDesktop .
Desktop ini harus dikaitkan dengan stasiun jendela saat ini untuk proses tersebut.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Fungsi SetThreadDesktop akan gagal jika utas panggilan memiliki jendela atau kait pada desktop saat ini (kecuali parameter hDesktop adalah handel ke desktop saat ini).
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 (sertakan Windows.h) |
Pustaka | User32.lib |
DLL | User32.dll |
Set API | ext-ms-win-ntuser-windowstation-l1-1-0 (diperkenalkan dalam Windows 8) |