Função UnhookWinEvent (winuser.h)

Remove uma função de gancho de evento criada por uma chamada anterior para SetWinEventHook.

Sintaxe

BOOL UnhookWinEvent(
  [in] HWINEVENTHOOK hWinEventHook
);

Parâmetros

[in] hWinEventHook

Tipo: HWINEVENTHOOK

Identificador para o gancho de evento retornado na chamada anterior para SetWinEventHook.

Retornar valor

Tipo: BOOL

Se tiver êxito, retornará TRUE; caso contrário, retornará FALSE.

Três erros comuns fazem com que essa função falhe:

  • O parâmetro hWinEventHook é NULL ou não é válido.
  • O gancho de evento especificado por hWinEventHook já foi removido.
  • UnhookWinEvent é chamado de um thread diferente da chamada original para SetWinEventHook.

Comentários

Essa função remove o gancho de evento especificado por hWinEventHook que impede que a função de retorno de chamada correspondente receba mais notificações de eventos. Se o thread do cliente terminar, o sistema chamará automaticamente essa função.

Chame essa função do mesmo thread que instalou o gancho de evento. UnhookWinEvent falhará se for chamado de um thread diferente da chamada que corresponde a SetWinEventHook.

Se WINEVENT_INCONTEXT foi especificado quando esse gancho de evento foi instalado, o sistema tenta descarregar a DLL correspondente de todos os processos que o carregaram. Embora o descarregamento não ocorra imediatamente, a função de gancho não é chamada depois que UnhookWinEvent retorna. Para obter mais informações sobre WINEVENT_INCONTEXT, consulte Funções de gancho no contexto.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll
Redistribuível Active Accessibility 1.3 RDK no Windows NT 4.0 com SP6 e posterior e Windows 95