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