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

Статья
07/01/2023

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

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

Синтаксис

HOOKPROC Hookproc;

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

Параметры

code

[in] wParam

Тип: WPARAM

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

[in] lParam

Тип: LPARAM

Указатель на структуру CWPRETSTRUCT , содержащую сведения о сообщении.

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

Тип: LRESULT

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

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

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)

См. также раздел

Структура CWPRETSTRUCT, функция CallNextHookEx, функция CallWindowProcW, функция CallWindowProcA, SendMessage, SetWindowsHookEx, Перехватчики