Fungsi OpenInputDesktop (winuser.h)

  • Artikel

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
DF_ALLOWOTHERACCOUNTHOOK
0x0001
 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)

Lihat juga

CloseDesktop

Desktop

SetProcessWindowStation

SwitchDesktop

Stasiun Jendela dan Fungsi Desktop