CallMsgFilterA, fonction (winuser.h)

Article
11/20/2024

Transmet le message et le code de raccordement spécifiés aux procédures de raccordement associées aux WH_SYSMSGFILTER et WH_MSGFILTER hooks. Une procédure de raccordement WH_SYSMSGFILTER ou WH_MSGFILTER est une fonction de rappel définie par l’application qui examine et modifie éventuellement les messages d’une boîte de dialogue, d’une boîte de dialogue, d’une zone de message, d’un menu ou d’une barre de défilement.

Syntaxe

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

Paramètres

[in] lpMsg

Type : LPMSG

Pointeur vers une structure MSG qui contient le message à passer aux procédures de raccordement.

[in] nCode

Type : int

Code défini par l’application utilisé par la procédure de raccordement pour déterminer comment traiter le message. Le code ne doit pas avoir la même valeur que les codes de hook définis par le système (MSGF_ et HC_) associés aux crochets WH_SYSMSGFILTER et WH_MSGFILTER.

Valeur de retour

Type : BOOL

Si l’application doit traiter le message plus loin, la valeur de retour est égale à zéro.

Si l’application ne doit pas traiter le message plus loin, la valeur de retour n’est pas nulle.

Remarques

Le système appelle CallMsgFilter pour permettre aux applications d’examiner et de contrôler le flux de messages pendant le traitement interne des boîtes de dialogue, des boîtes de message, des menus et des barres de défilement, ou lorsque l’utilisateur active une autre fenêtre en appuyant sur la combinaison de touches ALT+TAB.

Installez cette procédure de raccordement à l’aide de la fonction SetWindowsHookEx.

Exemples

Pour obtenir un exemple, consultez WH_MSGFILTER et WH_SYSMSGFILTER Hooks.

Note

L’en-tête winuser.h définit CallMsgFilter comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	winuser.h (include Windows.h)
bibliothèque	User32.lib
DLL	User32.dll
ensemble d’API	ext-ms-win-ntuser-message-l1-1-0 (introduit dans Windows 8)