Функция обратного вызова HOOKPROC (winuser.h)

Определяемая приложением или библиотека функция обратного вызова, используемая с функцией SetWindowsHookEx . Система вызывает эту функцию после вызова функции SendMessage . Процедура перехватчика может проверить сообщение; он не может изменить его.

Тип HOOKPROC определяет указатель на эту функцию обратного вызова. CallWndRetProc — это заполнитель для имени определяемой приложением или библиотекой функции.

Syntax

HOOKPROC Hookproc;

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

Parameters

code

[in] wParam

Тип: WPARAM

Указывает, отправляется ли сообщение текущим процессом. Если сообщение отправляется текущим процессом, оно ненулевое; в противном случае значение NULL.

[in] lParam

Тип: LPARAM

Указатель на структуру CWPSTRUCT или CWPRETSTRUCT , содержащую сведения о сообщении, в зависимости от типа перехватчика, указанного при вызове функции SetWindowsHookEx .

Возвращаемое значение

Тип: LRESULT

Если nCode меньше нуля, процедура перехватчика должна возвращать значение, возвращаемое функцией CallNextHookEx.

Если nCode больше нуля или равно нулю, настоятельно рекомендуется вызывать функцию CallNextHookEx и возвращать возвращаемое значение; в противном случае другие приложения, которые установили WH_CALLWNDPROCRET перехватчиков, не получат уведомления об перехватчиках и могут вести себя неправильно. Если процедура перехватчика не вызывает CallNextHookEx, возвращаемое значение должно быть равно нулю.

Замечания

Приложение устанавливает процедуру перехватчика, указав тип WH_CALLWNDPROC или WH_CALLWNDPROCRET перехватчика и указатель на процедуру перехватчика в вызове функции SetWindowsHookEx .

Требования

Requirement Ценность
Минимальный поддерживаемый клиент Windows 2000 профессиональный [только классические приложения]
минимальный поддерживаемый сервер Windows 2000 Server [только классические приложения]
целевая платформа Windows
Заголовка winuser.h (включая Windows.h)

См. также

Структура CWPSTRUCT, структура CWPRETSTRUCT, функция CallNextHookEx, функция CallWindowProcW, функция CallWindowProcA, SendMessage, SetWindowsHookEx, Hook