Fonction MessageProc

Article
07/01/2023

Description

Fonction de rappel définie par l’application ou définie par la bibliothèque utilisée avec la fonction SetWindowsHookExW/SetWindowsHookExW . Le système appelle cette fonction après qu’un événement d’entrée se produit dans une boîte de dialogue, une boîte de message, un menu ou une barre de défilement, mais avant le traitement du message généré par l’événement d’entrée. La procédure de raccordement peut surveiller les messages d’une boîte de dialogue, d’une boîte de message, d’un menu ou d’une barre de défilement créée par une application particulière ou toutes les applications.

Le type HOOKPROC définit un pointeur vers cette fonction de rappel. MessageProc est un espace réservé pour le nom de fonction défini par l’application ou défini par la bibliothèque.

LRESULT CALLBACK MessageProc(
  _In_ int    code,
       WPARAM wParam,
  _In_ LPARAM lParam
);

Paramètres

code [in]

Type : int

Type d’événement d’entrée qui a généré le message.

Si le code est inférieur à zéro, la procédure de hook doit passer le message à la fonction CallNextHookEx sans traitement supplémentaire et retourner la valeur retournée par CallNextHookEx.

Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
0x8001 MSGF_DDEMGR	L’événement d’entrée s’est produit alors que la bibliothèque de gestion DDEML (Dynamic Data Exchange Management Library) attendait la fin d’une transaction synchrone. Pour plus d’informations sur DDEML, consultez Bibliothèque de gestion Dynamic Data Exchange.
MSGF_DIALOGBOX 0	L’événement d’entrée s’est produit dans une boîte de message ou une boîte de dialogue.
MSGF_MENU 2	L’événement d’entrée s’est produit dans un menu.
MSGF_SCROLLBAR 5	L’événement d’entrée s’est produit dans une barre de défilement.

wParam

Type : WPARAM

Ce paramètre n'est pas utilisé.

lParam [in]

Type : LPARAM

Pointeur vers une structure MSG .

Retours

Type : LRESULT

Si le code est inférieur à zéro, la procédure de raccordement doit retourner la valeur retournée par CallNextHookEx.

Si le code est supérieur ou égal à zéro et que la procédure de hook n’a pas traiter le message, il est vivement recommandé d’appeler CallNextHookEx et de retourner la valeur qu’il retourne ; dans le cas contraire, d’autres applications qui ont installé des hooks WH_MSGFILTER ne recevront pas de notifications de hook et risquent de se comporter de manière incorrecte. Si la procédure de raccordement a traité le message, elle peut retourner une valeur différente de zéro pour empêcher le système de transmettre le message au reste de la chaîne de raccordement ou à la procédure de fenêtre cible.

Notes

Une application installe la procédure de raccordement en spécifiant le type de hook WH_MSGFILTER et un pointeur vers la procédure de hook dans un appel à la fonction SetWindowsHookExA/SetWindowsHookExW .

Si une application qui utilise le DDEML et effectue des transactions synchrones doit traiter les messages avant qu’ils ne soient distribués, elle doit utiliser le hook WH_MSGFILTER .

Voir aussi