enumDesktopWindows 函式 (winuser.h)

列舉與指定桌面相關聯的所有最上層視窗。它會將句柄傳遞至每個視窗，進而傳遞至應用程式定義的回呼函式。

語法

BOOL EnumDesktopWindows(
  [in, optional] HDESK       hDesktop,
  [in]           WNDENUMPROC lpfn,
  [in]           LPARAM      lParam
);

[in, optional] hDesktop

要列舉最上層視窗之桌面的句柄。這個句柄是由 CreateDesktop、GetThreadDesktop、OpenDesktop 或 OpenInputDesktop 函式傳回，而且必須具有DESKTOP_READOBJECTS訪問許可權。如需詳細資訊，請參閱桌面安全性和訪問許可權。

如果此參數為 NULL，則會使用目前的桌面。

[in] lpfn

應用程式定義 EnumWindowsProc 回呼函式的指標。

[in] lParam

要傳遞至回調函式的應用程式定義值。

如果函式失敗或無法執行列舉，則傳回值為零。

若要取得擴充的錯誤資訊，請呼叫 GetLastError。

如果回呼函式失敗，您必須確定回呼函式會設定 SetLastError 。

Windows Server 2003 和 Windows XP/2000： 如果桌面上沒有視窗， GetLastError 會 傳回ERROR_INVALID_HANDLE。

EnumDesktopWindows 函式會重複叫用 lpfn 回呼函式，直到列舉最後一個最上層視窗或回呼函式傳回 FALSE 為止。

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	winuser.h (包含 Windows.h)
程式庫	User32.lib
Dll	User32.dll
API 集合	ext-ms-win-ntuser-windowstation-l1-1-0 (於 Windows 8) 中引進