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) 中引進 |