CHANGEFILTERSTRUCT-Struktur (winuser.h)

Artikel
08/28/2023

Enthält erweiterte Ergebnisinformationen, die durch Aufrufen der ChangeWindowMessageFilterEx-Funktion abgerufen werden.

Syntax

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

Member

cbSize

Art: DWORD

Die Größe der Struktur in Bytes. Muss auf sizeof(CHANGEFILTERSTRUCT)festgelegt werden, andernfalls schlägt die Funktion mit ERROR_INVALID_PARAMETER fehl.

ExtStatus

Art: DWORD

Wenn die Funktion erfolgreich ist, enthält dieses Feld einen der folgenden Werte.

Wert	Bedeutung
MSGFLTINFO_NONE 0	Weitere Informationen finden Sie im Abschnitt mit den Hinweisen. Gilt für MSGFLT_ALLOW und MSGFLT_DISALLOW.
MSGFLTINFO_ALLOWED_HIGHER 3	Die Nachricht ist in einem Bereich zulässig, der höher als das Fenster ist. Gilt für MSGFLT_DISALLOW.
MSGFLTINFO_ALREADYALLOWED_FORWND 1	Die Nachricht wurde bereits vom Nachrichtenfilter dieses Fensters zugelassen, und die Funktion war daher erfolgreich, ohne den Nachrichtenfilter des Fensters zu ändern. Gilt für MSGFLT_ALLOW.
MSGFLTINFO_ALREADYDISALLOWED_FORWND 2	Die Nachricht wurde bereits durch den Nachrichtenfilter dieses Fensters blockiert, und die Funktion war daher erfolgreich, ohne dass der Nachrichtenfilter des Fensters geändert wurde. Gilt für MSGFLT_DISALLOW.

Hinweise

Bestimmte Nachrichten, deren Wert kleiner als WM_USER ist, müssen den Filter unabhängig von der Filtereinstellung durchlaufen. Es gibt keine Auswirkungen, wenn Sie versuchen, diese Funktion zu verwenden, um solche Meldungen zuzulassen oder zu blockieren.

Eine Anwendung kann die ChangeWindowMessageFilter-Funktion verwenden, um eine Nachricht prozessweit zuzulassen oder zu blockieren. Wenn die Nachricht entweder durch den Prozessnachrichtenfilter oder den Fensternachrichtenfilter zugelassen wird, wird sie an das Fenster übermittelt.

In der folgenden Tabelle sind die möglichen Werte aufgeführt, die in ExtStatus zurückgegeben werden.

Nachricht, die bereits für einen höheren Bereich zulässig ist	Nachricht, die bereits vom Nachrichtenfilter des Fensters zugelassen ist	Angeforderter Vorgang	In ExtStatus bei Erfolg zurückgegebener Indikator
Nein	Nein	MSGFLT_ALLOW	MSGFLTINFO_NONE
Nein	Nein	MSGFLT_DISALLOW	MSGFLTINFO_ALREADYDISALLOWED_FORWND
Nein	Nein	MSGFLT_RESET	MSGFLTINFO_NONE
Nein	Ja	MSGFLT_ALLOW	MSGFLTINFO_ALREADYALLOWED_FORWND
Nein	Ja	MSGFLT_DISALLOW	MSGFLTINFO_NONE
Nein	Ja	MSGFLT_RESET	MSGFLTINFO_NONE
Ja	Nein	MSGFLT_ALLOW	MSGFLTINFO_NONE
Ja	Nein	MSGFLT_DISALLOW	MSGFLTINFO_ALLOWED_HIGHER
Ja	Nein	MSGFLT_RESET	MSGFLTINFO_NONE
Ja	Ja	MSGFLT_ALLOW	MSGFLTINFO_ALREADYALLOWED_FORWND
Ja	Ja	MSGFLT_DISALLOW	MSGFLTINFO_ALLOWED_HIGHER
Ja	Ja	MSGFLT_RESET	MSGFLTINFO_NONE

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Kopfzeile	winuser.h (windows.h einschließen)

Weitere Informationen

ChangeWindowMessageFilterEx

Freigeben über