Struktur CHANGEFILTERSTRUCT (winuser.h)

Artikel
08/28/2023

Berisi informasi hasil yang diperluas yang diperoleh dengan memanggil fungsi ChangeWindowMessageFilterEx .

Sintaks

typedef struct tagCHANGEFILTERSTRUCT {
  DWORD cbSize;
  DWORD ExtStatus;
} CHANGEFILTERSTRUCT, *PCHANGEFILTERSTRUCT;

Anggota

cbSize

Jenis: DWORD

Ukuran struktur, dalam byte. Harus diatur ke sizeof(CHANGEFILTERSTRUCT), jika tidak, fungsi gagal dengan ERROR_INVALID_PARAMETER.

ExtStatus

Jenis: DWORD

Jika fungsi berhasil, bidang ini berisi salah satu nilai berikut.

Nilai	Makna
MSGFLTINFO_NONE 0	Lihat bagian Keterangan. Berlaku untuk MSGFLT_ALLOW dan MSGFLT_DISALLOW.
MSGFLTINFO_ALLOWED_HIGHER 3	Pesan diperbolehkan pada cakupan yang lebih tinggi dari jendela. Berlaku untuk MSGFLT_DISALLOW.
MSGFLTINFO_ALREADYALLOWED_FORWND 1	Pesan telah diizinkan oleh filter pesan jendela ini, dan fungsi dengan demikian berhasil tanpa perubahan pada filter pesan jendela. Berlaku untuk MSGFLT_ALLOW.
MSGFLTINFO_ALREADYDISALLOWED_FORWND 2	Pesan telah diblokir oleh filter pesan jendela ini, dan fungsinya dengan demikian berhasil tanpa perubahan pada filter pesan jendela. Berlaku untuk MSGFLT_DISALLOW.

Keterangan

Pesan tertentu yang nilainya lebih kecil dari WM_USER diperlukan untuk melewati filter, terlepas dari pengaturan filter. Tidak akan ada efek ketika Anda mencoba menggunakan fungsi ini untuk mengizinkan atau memblokir pesan tersebut.

Aplikasi dapat menggunakan fungsi ChangeWindowMessageFilter untuk mengizinkan atau memblokir pesan dengan cara di seluruh proses. Jika pesan diizinkan oleh filter pesan proses atau filter pesan jendela, pesan tersebut akan dikirim ke jendela.

Tabel berikut ini mencantumkan kemungkinan nilai yang dikembalikan di ExtStatus.

Pesan sudah diizinkan pada cakupan yang lebih tinggi	Pesan sudah diizinkan oleh filter pesan jendela	Operasi yang diminta	Indikator dikembalikan di ExtStatus pada keberhasilan
Tidak	Tidak	MSGFLT_ALLOW	MSGFLTINFO_NONE
Tidak	Tidak	MSGFLT_DISALLOW	MSGFLTINFO_ALREADYDISALLOWED_FORWND
Tidak	Tidak	MSGFLT_RESET	MSGFLTINFO_NONE
Tidak	Ya	MSGFLT_ALLOW	MSGFLTINFO_ALREADYALLOWED_FORWND
Tidak	Ya	MSGFLT_DISALLOW	MSGFLTINFO_NONE
Tidak	Ya	MSGFLT_RESET	MSGFLTINFO_NONE
Ya	Tidak	MSGFLT_ALLOW	MSGFLTINFO_NONE
Ya	Tidak	MSGFLT_DISALLOW	MSGFLTINFO_ALLOWED_HIGHER
Ya	Tidak	MSGFLT_RESET	MSGFLTINFO_NONE
Ya	Ya	MSGFLT_ALLOW	MSGFLTINFO_ALREADYALLOWED_FORWND
Ya	Ya	MSGFLT_DISALLOW	MSGFLTINFO_ALLOWED_HIGHER
Ya	Ya	MSGFLT_RESET	MSGFLTINFO_NONE

Persyaratan


Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Header	winuser.h (sertakan Windows.h)

Lihat juga

ChangeWindowMessageFilterEx

Bagikan melalui