IsWinEventHookInstalled 関数 (winuser.h)

  • [アーティクル]

指定したイベントの通知を受け取る可能性のある WinEvent フックがインストールされているかどうかを判断します。

構文

BOOL IsWinEventHookInstalled(
  [in] DWORD event
);

パラメーター

[in] event

種類: DWORD

フックが通知される可能性があるイベント定数。 関数は、このイベント定数のフックがインストールされているかどうかを確認します。

戻り値

種類: BOOL

指定したイベントの通知を受け取るフックがある場合、戻り値は TRUE です。

指定したイベントの通知を受け取るフックがない場合、戻り値は FALSE です。

解説

このメソッドは、偽の負の値を返さないことを保証します。 このメソッドが FALSE を返す場合は、システム内のフックがイベントの通知を受け取らないことを意味します。 ただし、このメソッドは誤検知を返す場合があります。 つまり、通知されるフックがない場合でも TRUE を 返す可能性があります。 したがって、このメソッドが FALSE を返す場合、コンポーネントは何らかの作業を回避しても安全です。

イベント フックはいつでもインストールできるため、サーバー開発者は、戻り値を長期間キャッシュしないでください。

要件

   
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー winuser.h
Library User32.lib
[DLL] User32.dll
再頒布可能パッケージ SP6 以降および Windows 98 を使用した Windows NT 4.0 の Active Accessibility 2.0 RDK
API セット ext-ms-win-ntuser-server-l1-1-1 (Windows 10 バージョン 10.0.14393 で導入)

関連項目

SetWinEventHook

UnhookWinEvent