Fonction de rappel HOOKPROC (winuser.h)

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 ; elle ne peut pas la 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 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 actuel. Si le message est envoyé par le processus actuel, il n’est pas différent de zéro ; sinon, il s’agit de NULL.

[in] lParam

Type : LPARAM

Pointeur vers une structure CWPSTRUCT ou CWPRETSTRUCT qui contient des détails sur le message, selon le type de hook spécifié lors de l’appel de la fonction SetWindowsHookEx .

Valeur renvoyé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 renvoyer la valeur retournée ; sinon, les autres applications qui ont installé WH_CALLWNDPROCRET crochets ne recevront pas de notifications de hook et peuvent se comporter de manière incorrecte en conséquence. Si la procédure de hook n’appelle pas CallNextHookEx, la valeur de retour doit être égale à zéro.

Remarques

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

Exigences

Requirement	Valeur
Client minimum requis	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 (include Windows.h)

Voir aussi

Structure CWPSTRUCT, structure CWPRETSTRUCT, Fonction CallNextHookEx, Fonction CallWindowProcW, Fonction CallWindowProcA, SendMessage, SetWindowsHookEx, Hooks