Win32 API. Hooks (хуки) - Функция CallWndRetProc

ОГЛАВЛЕНИЕ

Функция CallWndRetProc

(ПовторныйВызовОконнойПроцедуры)

[Теперь поддерживается Windows NT]

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

Синтаксис

LRESULT CALLBACK CallWndRetProc
(
int nCode, // код hook-точки
WPARAM wParam, // флажок текущей обработки
LPARAM lParam // адрес структуры с данными сообщения
);

Параметры
nCode
Определяет должна ли подключаемая процедура обрабатывать сообщение. Если nCode - HC_ACTION, фильтр - процедура должна обработать сообщение. Если nCode - меньше чем нуль, подключаемая процедура должна передать сообщение в функцию CallNextHookEx без дальнейшей обработки и должна возвратить значение, возвращенное CallNextHookEx.
wParam
Определяет, не отправлено ли сообщение текущим процессом. Если сообщение отправляется текущим процессом, оно отлично от нуля; иначе, оно значение ПУСТО (NULL).
lParam
Указатель на структуру CWPRETSTRUCT, которая содержит подробности о сообщении.

Возвращаемые значения
Величина возвращаемого значения должна быть нуль.

Замечания
Прикладная программа устанавливает подключаемую процедуру, определяя тип hook-точки WH_CALLWNDPROCRET и адрес фильтр - процедуры при вызове функции SetWindowsHookEx. CallWndRetProc - метка - заместитель для определяемого программой или определенного библиотекой имени функции.

Смотри также
CallNextHookEx, CallWndProc, CWPRETSTRUCT, SendMessage, SetWindowsHookEx.

Размещение и совместимость CallWndRetProc

Windows NT				Да 
Win95 Да
Win32s Нет
Импортируемая библиотека Определенная пользователем
Заголовочный файл winuser.h
Unicode Нет
Замечания по платформе HOOKPROC