Fonction de rappel CallWndProc

Fonction de rappel définie par l’application ou définie par la bibliothèque utilisée avec la fonction SetWindowsHookExA/SetWindowsHookExW . Le système appelle cette fonction avant d’appeler la procédure de fenêtre pour traiter un message envoyé au thread.

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

Syntaxe

LRESULT CALLBACK CallWndProc(
  _In_ int    nCode,
  _In_ WPARAM wParam,
  _In_ LPARAM lParam
);

Paramètres

• nCode [in]
  Type : int

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

• wParam [in]
  Type : WPARAM

  Spécifie si le message a été envoyé par le thread actif. Si le message a été envoyé par le thread actif, il est différent de zéro ; sinon, il est égal à zéro.

• lParam [in]
  Type : LPARAM

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

Valeur retournée

Type:****

Type : LRESULT

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

Si nCode est supérieur ou égal à zéro, 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é WH_CALLWNDPROC hooks ne recevront pas de notifications de hook et peuvent se comporter de manière incorrecte. Si la procédure de hook n’appelle pas CallNextHookEx, la valeur de retour doit être égale à zéro.

Notes

La procédure de crochet CallWndProc peut examiner le message, mais elle ne peut pas le modifier. Une fois que la procédure de crochet retourne le contrôle au système, le message est passé à la procédure de fenêtre.

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

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]
En-tête	Winuser.h (y compris Windows.h)

Voir aussi

CallNextHookEx

CWPSTRUCT

SendMessage

SetWindowsHookExA/SetWindowsHookExW

Hooks