CallMsgFilterA-Funktion (winuser.h)

Artikel
07/01/2023

Ü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 Meldungen für ein Dialogfeld, ein Meldungsfeld, ein Menü oder eine Bildlaufleiste untersucht und optional ändert.

Syntax

BOOL CallMsgFilterA(
  [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 wird. 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 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 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 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


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 (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-message-l1-1-0 (eingeführt in Windows 8)