次の方法で共有


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で導入)

関連項目

概念

EnumChildWindows

EnumWindowsProc

GetWindow

リファレンス

Windows