Fonction de rappel HOOKPROC (winuser.h)

Article
07/01/2023

Fonction de rappel définie par l’application ou définie par la bibliothèque utilisée avec la fonction SetWindowsHookEx . Le système appelle cette fonction après l’appel de la fonction SendMessage . La procédure de raccordement peut examiner le message ; il ne peut pas le modifier.

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

Syntaxe

HOOKPROC Hookproc;

LRESULT Hookproc(
       int code,
  [in] WPARAM wParam,
  [in] LPARAM lParam
)
{...}

Paramètres

code

[in] wParam

Type : WPARAM

Spécifie si le message est envoyé par le processus en cours. Si le message est envoyé par le processus actuel, il est différent de zéro ; sinon, elle est NULL.

[in] lParam

Type : LPARAM

Pointeur vers une structure CWPRETSTRUCT qui contient des détails sur le message.

Valeur retournée

Type : LRESULT

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

Si nCode est supérieur ou égal à zéro, il est vivement recommandé d’appeler la fonction CallNextHookEx et de retourner la valeur qu’elle retourne . dans le cas contraire, d’autres applications qui ont installé des hooks WH_CALLWNDPROCRET ne recevront pas de notifications de hook et risquent de se comporter de manière incorrecte. Si la procédure de raccordement n’appelle pas CallNextHookEx, la valeur de retour doit être zéro.

Notes

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

Spécifications


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)

Voir aussi

Structure CWPRETSTRUCT, fonction CallNextHookEx, fonction CallWindowProcW, fonction CallWindowProcA, SendMessage, SetWindowsHookEx, Hooks

Partager via