Функция 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

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz