EnumWindows 関数 (winuser.h)

各ウィンドウにハンドルを渡し、アプリケーション定義のコールバック関数に渡すことによって、画面上のすべての最上位ウィンドウを列挙します。 EnumWindows は 、最後の最上位ウィンドウが列挙されるか、コールバック関数から FALSE が返されるまで続行 されます。

構文

BOOL EnumWindows(
  [in] WNDENUMPROC lpEnumFunc,
  [in] LPARAM      lParam
);

[in] lpEnumFunc

種類: WNDENUMPROC

アプリケーション定義のコールバック関数へのポインター。詳細については、「 EnumWindowsProc」を参照してください。

[in] lParam

型: LPARAM

コールバック関数に渡されるアプリケーション定義の値。

種類: BOOL

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。詳細なエラー情報を得るには、GetLastError を呼び出します。

EnumWindowsProc が 0 を返す場合、戻り値も 0 になります。この場合、コールバック関数は SetLastError を呼び出して、 EnumWindows の呼び出し元に返される意味のあるエラーコードを取得する必要があります。

EnumWindows 関数は子ウィンドウを列挙しませんが、WS_CHILD スタイルを持つシステムが所有する最上位のウィンドウをいくつか除きます。

この関数は、ループ内で GetWindow 関数を呼び出すよりも信頼性が高くなります。 GetWindow を呼び出してこのタスクを実行するアプリケーションは、無限ループでキャッチされたり、破棄されたウィンドウへのハンドルを参照したりするリスクがあります。

メモWindows 8以降の場合、EnumWindows はデスクトップアプリの最上位ウィンドウのみを列挙します。

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	winuser.h (Windows.h を含む)
Library	User32.lib
[DLL]	User32.dll
API セット	ext-ms-win-ntuser-window-l1-1-0 (Windows 8で導入)