Fungsi OpenInputDesktop (winuser.h)
Membuka desktop yang menerima input pengguna.
Sintaks
HDESK OpenInputDesktop(
[in] DWORD dwFlags,
[in] BOOL fInherit,
[in] ACCESS_MASK dwDesiredAccess
);
Parameter
[in] dwFlags
Parameter ini bisa nol atau nilai berikut.
| Nilai | Makna |
|---|---|
|
Memungkinkan proses yang berjalan di akun lain di desktop untuk mengatur kait dalam proses ini. |
[in] fInherit
Jika nilai ini TRUE, proses yang dibuat oleh proses ini akan mewarisi handel. Jika tidak, proses tidak mewarisi handel ini.
[in] dwDesiredAccess
Akses ke desktop. Untuk daftar hak akses, lihat Keamanan Desktop dan Hak Akses.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke desktop yang menerima input pengguna. Setelah Anda selesai menggunakan handel, panggil fungsi CloseDesktop untuk menutupnya.
Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Proses panggilan harus memiliki stasiun jendela terkait, baik yang ditetapkan oleh sistem saat proses dibuat, atau diatur oleh fungsi SetProcessWindowStation . Stasiun jendela yang terkait dengan proses panggilan harus mampu menerima input.
Jika proses panggilan berjalan dalam sesi terputus, fungsi mengembalikan handel ke desktop yang menjadi aktif saat pengguna memulihkan koneksi.
Aplikasi dapat menggunakan fungsi SwitchDesktop untuk mengubah desktop input.
Jika parameter dwDesiredAccess menentukan hak akses standar READ_CONTROL, WRITE_DAC, atau WRITE_OWNER , Anda juga harus meminta hak akses DESKTOP_READOBJECTS dan DESKTOP_WRITEOBJECTS .
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-1 (diperkenalkan dalam Windows 8.1) |