CallMsgFilterW-Funktion (winuser.h)

Artikel
03/04/2024

Übergibt die angegebene Nachricht und den angegebenen Hookcode an die Hookprozeduren, die den WH_SYSMSGFILTER und WH_MSGFILTER Hooks zugeordnet sind. Eine WH_SYSMSGFILTER oder WH_MSGFILTER Hookprozedur ist eine anwendungsdefinierte Rückruffunktion, die Nachrichten für ein Dialogfeld, ein Meldungsfeld, ein Menü oder eine Bildlaufleiste untersucht und optional ändert.

Syntax

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 Hookprozeduren übergeben werden soll.

[in] nCode

Typ: int

Ein anwendungsdefinierter Code, der von der Hookprozedur verwendet wird, um zu bestimmen, wie die Nachricht verarbeitet werden soll. Der Code darf nicht den gleichen 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 0.

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

Hinweise

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 diese Hookprozedur 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 nicht codierungsneutralem Code 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
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-message-l1-1-0 (eingeführt in Windows 8)