Fungsi BlockInput (winuser.h)

Artikel
03/13/2024

Memblokir peristiwa input keyboard dan mouse agar tidak menjangkau aplikasi.

Sintaks

BOOL BlockInput(
  [in] BOOL fBlockIt
);

Parameter

[in] fBlockIt

Jenis: BOOL

Tujuan fungsi. Jika parameter ini TRUE, peristiwa input keyboard dan mouse akan diblokir. Jika parameter ini FALSE, peristiwa keyboard dan mouse tidak diblokir. Perhatikan bahwa hanya utas yang memblokir input yang berhasil membuka blokir input.

Nilai kembali

Jenis: BOOL

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika input sudah diblokir, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Ketika input diblokir, input fisik nyata dari mouse atau keyboard tidak akan memengaruhi status kunci sinkron antrean input (dilaporkan oleh GetKeyState dan GetKeyboardState), juga tidak akan memengaruhi status kunci asinkron (dilaporkan oleh GetAsyncKeyState). Namun, utas yang memblokir input dapat memengaruhi kedua status utama ini dengan memanggil SendInput. Tidak ada utas lain yang bisa melakukan ini.

Sistem akan membuka blokir input dalam kasus berikut:

Utas yang memblokir input tiba-tiba keluar tanpa memanggil BlockInput dengan fBlock diatur ke FALSE. Dalam hal ini, sistem membersihkan dengan benar dan mengaktifkan kembali input.
Pengguna menekan CTRL+ALT+DEL atau sistem memanggil kotak pesan modal Kesalahan Sistem Keras (misalnya, ketika kesalahan program atau perangkat gagal).

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
Pustaka	User32.lib
DLL	User32.dll