Função IsWinEventHookInstalled (winuser.h)

Determina se há um gancho WinEvent instalado que pode ser notificado de um evento especificado.

Sintaxe

BOOL IsWinEventHookInstalled(
  [in] DWORD event
);

Parâmetros

[in] event

Tipo: DWORD

A constante de evento da qual os ganchos podem ser notificados. A função verifica se há um gancho instalado para essa constante de evento.

Valor retornado

Tipo: BOOL

Se houver um gancho a ser notificado do evento especificado, o valor retornado será TRUE.

Se não houver ganchos a serem notificados sobre o evento especificado, o valor retornado será FALSE.

Comentários

Esse método tem a garantia de nunca retornar um falso negativo. Se esse método retornar FALSE, significa que nenhum gancho no sistema será notificado do evento. No entanto, esse método pode retornar um falso positivo. Em outras palavras, ele pode retornar TRUE mesmo que não haja ganchos que sejam notificados. Portanto, é seguro que os componentes contornem algum trabalho se esse método retornar FALSE.

Os ganchos de evento podem ser instalados a qualquer momento, portanto, os desenvolvedores de servidores não devem armazenar em cache o valor retornado por longos períodos de tempo.

Requisitos

Confira também

SetWinEventHook

UnhookWinEvent