Функция CallWndProc


Фильтр-процедура (hook) CallWndProc - определяемая программой или определяемая библиотекой функция повторного вызова, используемая функцией SetWindowsHookEx.

Тип HOOKPROC определяет указатель на эту функция повторного вызова. CallWndProc - имя - заместитель для определяемого программой или определяемого библиотекой имени функции.

Синтаксис

LRESULT CALLBACK CallWndProc(
    int nCode,
    WPARAM wParam,
    LPARAM lParam
);

Параметры

nCode

[in] Устанавливает, должна ли процедура фильтра (hook) обрабатывать сообщение. Если nCode равен HC_ACTION, процедура фильтра (hook) должна обработать сообщение. Если nCode - меньше чем нуль, процедура фильтра (hook) должна передать сообщение в функцию CallNextHookEx без дальнейшей обработки и должна возвратить значение, возвращенное CallNextHookEx.

wParam

[in] Устанавливает, отправлялось ли сообщение текущим потоком. Если сообщение отправлялось текущим потоком, параметр не нуль; в противном случае, он равняется нулю.

lParam

[in] Указатель на структуру CWPSTRUCT, которая содержит подробности о сообщении.

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

Если параметр nCode - меньше чем нуль, процедура фильтра (hook) должна возвратить значение, возвращенное CallNextHookEx.

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

Замечания

Процедура фильтра (hook) CallWndProc  может проверить сообщение, но она не может eго изменить. После того, как процедура фильтра (hook) возвращает управление системе, сообщение передается в оконную процедуру.

Приложение устанавливает процедуру фильтра (hook), определяя тип фильтра  WH_CALLWNDPROC и указатель на процедуру фильтра (hook) при вызове функции SetWindowsHookEx.

Смотри также

Обзор Фильтр-процедуры (hooks) событий, Функции, используемые фильтрами (hook), CallNextHookEx, CWPSTRUCT, SendMessage, SetWindowsHookEx

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

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да версии 3.1 и выше

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

Нет

Заголовочный файл

 

- объявлено в

Winuser.h

- включено в

Windows.h

Unicode

Нет

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

Не имеется

 

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

Hosted by uCoz