Compartilhar via


Função UnhookWindowsHookEx (winuser.h)

Remove um procedimento de gancho instalado em uma cadeia de ganchos pela função SetWindowsHookEx .

Sintaxe

BOOL UnhookWindowsHookEx(
  [in] HHOOK hhk
);

Parâmetros

[in] hhk

Tipo: HHOOK

Um identificador para o gancho a ser removido. Esse parâmetro é um identificador de gancho obtido por uma chamada anterior para SetWindowsHookEx.

Valor retornado

Tipo: BOOL

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

O procedimento de gancho pode estar no estado de ser chamado por outro thread mesmo após o retorno de UnhookWindowsHookEx . Se o procedimento de gancho não estiver sendo chamado simultaneamente, o procedimento de gancho será removido imediatamente antes que UnhookWindowsHookEx retorne.

Exemplos

Para obter um exemplo, consulte Monitorando eventos do sistema.

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)
Biblioteca User32.lib
DLL User32.dll
Conjunto de APIs ext-ms-win-ntuser-window-l1-1-0 (introduzido no Windows 8)

Confira também

Conceitual

Ganchos

Referência

SetWindowsHookEx