Функция GetMsgProc

Статья
01/31/2024

-Описание

Определяемая приложением или библиотека функция обратного вызова, используемая с функцией SetWindowsHookExA/SetWindowsHookExW. Система вызывает эту функцию всякий раз, когда функция GetMessage или PeekMessageA/PeekMessageW извлекла сообщение из очереди сообщений приложения. Перед возвращением полученного сообщения вызывающей системе передается сообщение в процедуру перехватчика.

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

LRESULT CALLBACK GetMsgProc(
  _In_ int    code,
  _In_ WPARAM wParam,
  _In_ LPARAM lParam
);

-Параметры

код [in]

Тип: int

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

wParam [in]

Тип: WPARAM

Указывает, удалено ли сообщение из очереди. Этот параметр может принимать одно из указанных ниже значений.

Значение	Значение
PM_NOREMOVE 0x0000	Сообщение не было удалено из очереди. (Приложение называется Функция PeekMessage , указывающая флаг PM_NOREMOVE .)
PM_REMOVE 0x0001	Сообщение было удалено из очереди. (Вызываемое приложениеGetMessage или вызывает функцию PeekMessage, указав флаг PM_REMOVE.)

lParam [in]

Тип: LPARAM

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

-Возвращает

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

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

-Замечания

Процедура перехватчика GetMsgProc может проверять или изменять сообщение.

После того как процедура перехватчика возвращает управление системой, функция GetMessage или PeekMessageA/ PeekMessageW возвращает сообщение вместе с любыми изменениями в приложение, которое первоначально назвало его.

Приложение устанавливает эту процедуру перехватчика, указав тип перехватчика WH_GETMESSAGE и указатель на процедуру перехватчика в вызове функции SetWindowsHookExA/SetWindowsHookExW.