CallMsgFilterA, fonction (winuser.h)

Article
07/21/2023

Transmet le message et le code de hook spécifiés aux procédures de hook 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, éventuellement, modifie les messages d’une boîte de dialogue, d’une boîte 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 raccordement définis par le système (MSGF_ et HC_) associés aux crochets WH_SYSMSGFILTER et WH_MSGFILTER .

Valeur retournée

Type : BOOL

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

Si l’application ne doit pas traiter le message plus loin, la valeur de retour est différente de zéro.

Notes

Le système appelle CallMsgFilter pour permettre aux applications d’examiner et de contrôler le flux des 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 crochets WH_MSGFILTER et WH_SYSMSGFILTER.

Notes

L’en-tête winuser.h définit CallMsgFilter en tant qu’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. La combinaison 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.

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-message-l1-1-0 (introduit dans Windows 8)