Função de retorno de chamada HOOKPROC (winuser.h)

Uma função de retorno de chamada definida pelo aplicativo ou definida pela biblioteca usada com a função SetWindowsHookEx . O sistema chama essa função depois que a função SendMessage é chamada. O procedimento de gancho pode examinar a mensagem; ele não pode modificá-lo.

O tipo HOOKPROC define um ponteiro para essa função de retorno de chamada. CallWndRetProc é um espaço reservado para o nome da função definida pelo aplicativo ou pela biblioteca.

Sintaxe

HOOKPROC Hookproc;

LRESULT Hookproc(
       int code,
  [in] WPARAM wParam,
  [in] LPARAM lParam
)
{...}

Parâmetros

code

[in] wParam

Tipo: WPARAM

Especifica se a mensagem é enviada pelo processo atual. Se a mensagem for enviada pelo processo atual, ela será diferente de zero; caso contrário, será NULL.

[in] lParam

Tipo: LPARAM

Um ponteiro para uma estrutura CWPRETSTRUCT que contém detalhes sobre a mensagem.

Retornar valor

Tipo: LRESULT

Se nCode for menor que zero, o procedimento de gancho deverá retornar o valor retornado pela função CallNextHookEx.

Se nCode for maior ou igual a zero, é altamente recomendável que você chame a função CallNextHookEx e retorne o valor retornado; caso contrário, outros aplicativos que instalaram ganchos de WH_CALLWNDPROCRET não receberão notificações de gancho e poderão se comportar incorretamente como resultado. Se o procedimento de gancho não chamar CallNextHookEx, o valor retornado deverá ser zero.

Comentários

Um aplicativo instala o procedimento de gancho especificando o tipo de gancho WH_CALLWNDPROCRET e um ponteiro para o procedimento de gancho em uma chamada para a função SetWindowsHookEx .

Requisitos

Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)

Confira também

Estrutura CWPRETSTRUCT, função CallNextHookEx, função CallWindowProcW, função CallWindowProcA, SendMessage, SetWindowsHookEx, Hooks