Fungsi RegisterPointerInputTarget (winuser.h)

Memungkinkan penelepon untuk mendaftarkan jendela target tempat semua input pointer dari jenis yang ditentukan dialihkan.

Sintaks

BOOL RegisterPointerInputTarget(
  [in] HWND               hwnd,
  [in] POINTER_INPUT_TYPE pointerType
);

Parameter

[in] hwnd

Jendela untuk mendaftar sebagai target pengalihan global.

Pengalihan dapat menyebabkan jendela latar depan kehilangan aktivasi (fokus). Untuk menghindari hal ini, pastikan jendela adalah jendela khusus pesan atau memiliki kumpulan gaya WS_EX_NOACTIVATE .

[in] pointerType

Jenis input pointer yang akan dialihkan ke jendela yang ditentukan. Ini adalah nilai yang valid dan didukung dari enumerasi POINTER_INPUT_TYPE . Perhatikan bahwa jenis PT_POINTER generik dan jenis PT_MOUSE tidak valid dalam parameter ini.

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

Aplikasi dengan hak istimewa Akses UI dapat menggunakan fungsi ini untuk mendaftarkan jendelanya sendiri untuk menerima semua input jenis input pointer yang ditentukan. Setiap desktop hanya mengizinkan satu jendela target pengalihan global tersebut untuk setiap jenis input pointer pada waktu tertentu. Jendela pertama yang berhasil didaftarkan tetap berlaku sampai jendela tidak terdaftar atau dihancurkan, di mana peran tersedia untuk penelepon yang memenuhi syarat berikutnya.

Saat pendaftaran berlaku, semua input jenis pointer yang ditentukan, baik dari perangkat input atau disuntikkan oleh aplikasi, dialihkan ke jendela terdaftar. Namun, ketika proses yang memiliki jendela terdaftar menyuntikkan input dari jenis pointer yang ditentukan, injeksi tersebut tidak dialihkan tetapi malah diproses secara normal.

Aplikasi yang ingin mendaftarkan jendela yang sama dengan target pengalihan global untuk beberapa jenis input pointer harus memanggil fungsi RegisterPointerInputTarget beberapa kali, sekali untuk setiap jenis input pointer yang menarik.

Jika utas panggilan tidak memiliki hak istimewa Akses UI, fungsi ini gagal dengan kesalahan terakhir yang diatur ke ERROR_ACCESS_DENIED.

Jika jenis input pointer yang ditentukan tidak valid, fungsi ini gagal dengan kesalahan terakhir diatur ke ERROR_INVALID_PARAMETER.

Jika utas panggilan tidak memiliki jendela yang ditentukan, fungsi ini gagal dengan kesalahan terakhir yang diatur ke ERROR_ACCESS_DENIED.

Jika desktop jendela yang ditentukan sudah memiliki target pengalihan global terdaftar untuk jenis input pointer yang ditentukan, fungsi ini gagal dengan kesalahan terakhir yang diatur ke ERROR_ACCESS_DENIED.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	winuser.h (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll