CallMsgFilterW-Funktion (winuser.h)

Artikel
20.11.2024

Übergibt den angegebenen Nachrichten- und Hook-Code an die Hook-Prozeduren, die den WH_SYSMSGFILTER und WH_MSGFILTER Hooks zugeordnet sind. Eine WH_SYSMSGFILTER- oder WH_MSGFILTER Hook-Prozedur ist eine anwendungsdefinierte Rückruffunktion, die Nachrichten für ein Dialogfeld, ein Meldungsfeld, ein Menü oder eine Bildlaufleiste untersucht und optional ändert.

Syntax

C++

BOOL CallMsgFilterW(
  [in] LPMSG lpMsg,
  [in] int   nCode
);

Parameter

[in] lpMsg

Typ: LPMSG-

Ein Zeiger auf eine MSG--Struktur, die die Nachricht enthält, die an die Hook-Prozeduren übergeben werden soll.

[in] nCode

Typ: int

Ein anwendungsdefinierter Code, der von der Hook-Prozedur verwendet wird, um zu bestimmen, wie die Nachricht verarbeitet wird. Der Code darf nicht denselben Wert wie systemdefinierte Hookcodes (MSGF_ und HC_) aufweisen, die den WH_SYSMSGFILTER und WH_MSGFILTER Hooks zugeordnet sind.

Rückgabewert

Typ: BOOL-

Wenn die Anwendung die Nachricht weiter verarbeiten soll, ist der Rückgabewert null.

Wenn die Anwendung die Nachricht nicht weiter verarbeiten soll, ist der Rückgabewert ungleich Null.

Bemerkungen

Das System ruft CallMsgFilter- auf, damit Anwendungen den Nachrichtenfluss während der internen Verarbeitung von Dialogfeldern, Meldungsfeldern, Menüs und Bildlaufleisten untersuchen und steuern können, oder wenn der Benutzer ein anderes Fenster durch Drücken der TASTENKOMBINATION ALT+TAB aktiviert.

Installieren Sie dieses Hook-Verfahren mithilfe der SetWindowsHookEx--Funktion.

Beispiele

Ein Beispiel finden Sie unter WH_MSGFILTER und WH_SYSMSGFILTER Hooks.

Hinweis

Der winuser.h-Header definiert CallMsgFilter als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winuser.h (enthalten Windows.h)
Library	User32.lib
DLL-	User32.dll
API-Satz	ext-ms-win-ntuser-message-l1-1-0 (eingeführt in Windows 8)