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 |