Fungsi UnregisterPointerInputTarget (winuser.h)

Memungkinkan pemanggil untuk membatalkan pendaftaran jendela target tempat semua input penunjuk dari jenis yang ditentukan dialihkan.

Sintaks

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

Parameter

[in] hwnd

Jendela yang tidak terdaftar sebagai target pengalihan global di desktopnya.

[in] pointerType

Jenis input pointer untuk tidak lagi 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 yang berhasil memanggil fungsi RegisterPointerInputTarget dapat memanggil fungsi ini untuk membatalkan pendaftaran jendela dari peran target yang dialihkan global untuk jenis penunjuk yang ditentukan.

Aplikasi yang telah mendaftarkan jendela yang sama dengan target pengalihan global untuk beberapa jenis input pointer dapat memanggil UnregisterPointerInputTarget untuk membatalkan pendaftaran jendela untuk salah satu jenis tersebut sambil membiarkan jendela terdaftar untuk jenis yang tersisa.

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 jendela yang ditentukan bukan target pengalihan global terdaftar untuk jenis input pointer yang ditentukan di desktopnya, fungsi ini tidak mengambil tindakan dan mengembalikan keberhasilan.

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