Функция CallWndRetProc
Процедура фильтра (hook) CallWndRetProc - это определяемая программой или определяемая библиотекой функция повторного вызова, используемая функцией SetWindowsHookEx. Система вызывает эту функцию после того, как вызывается функция SendMessage. Эта процедура фильтра (hook) может проверить сообщение; она не может изменить его.
Тип HOOKPROC определяет указатель на эту функция повторного вызова. CallWndRetProc - это имя - заместитель для определяемого программой или определяемого библиотекой имени функции.
Синтаксис
LRESULT CALLBACK CallWndRetProc( int nCode, WPARAM wParam, LPARAM lParam ); |
Параметры
nCode
[in] Устанавливает, должна ли процедура фильтра (hook) обрабатывать сообщение. Если nCode - HC_ACTION, процедура фильтра (hook) должна обработать сообщение. Если nCode - меньше чем нуль, процедура фильтра (hook) должна передать сообщение в функцию CallNextHookEx без дальнейшей обработки и должна возвратить значение, возвращенное CallNextHookEx.wParam
[in] Устанавливает, отправляется ли сообщение текущим процессом. Если сообщение отправляется текущим процессом, параметр не нуль; в противном случае, он - ПУСТО (NULL).lParam
[in] Указатель на структуру CWPRETSTRUCT, которая содержит детали о сообщении.Возвращаемое значение
Если параметр nCode - меньше чем нуль, процедура фильтра (hook) должна возвратить значение, возвращенное функцией CallNextHookEx.
Если nCode больше или равен нулю, то настоятельно рекомендуется, чтобы Вы вызвали CallNextHookEx и возвратили значение, которое она возвратила; в противном случае, другие прикладные программы, которые установили фильтр (hook) событий WH_CALLWNDPROCRET, не будут получать уведомления фильтра (hook) и, в результате, могут повести себя неправильно. Если процедура фильтра (hook) не вызывает CallNextHookEx, возвращаемое значение должно равняться нулю.
Замечания
Приложение устанавливает процедуру фильтра (hook), определяя тип фильтра (hook) WH_CALLWNDPROCRET и указатель на процедуру фильтра (hook) при вызове функции SetWindowsHookEx.
Смотри также
Обзор Фильтр-процедуры (hooks) событий, Функции, используемые фильтрами (hook), CallNextHookEx, CallWndProc, CWPRETSTRUCT, SendMessage, SetWindowsHookEx
|
Размещение и совместимость CallWndRetProc |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да версии 4.0 и выше |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
Нет |
|
Заголовочный файл |
|
|
- объявлено в |
Winuser.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |