Fungsi EnumDesktopWindows (winuser.h)

Artikel
08/27/2023

Menghitung semua jendela tingkat atas yang terkait dengan desktop yang ditentukan. Ini meneruskan handel ke setiap jendela, pada gilirannya, ke fungsi panggilan balik yang ditentukan aplikasi.

Sintaks

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

Parameter

[in, optional] hDesktop

Handel ke desktop yang jendela tingkat atasnya akan dijumlahkan. Handel ini dikembalikan oleh fungsi CreateDesktop, GetThreadDesktop, OpenDesktop, atau OpenInputDesktop , dan harus memiliki hak akses DESKTOP_READOBJECTS . Untuk informasi selengkapnya, lihat Keamanan Desktop dan Hak Akses.

Jika parameter ini NULL, desktop saat ini digunakan.

[in] lpfn

Penunjuk ke fungsi panggilan balik EnumWindowsProc yang ditentukan aplikasi.

[in] lParam

Nilai yang ditentukan aplikasi untuk diteruskan ke fungsi panggilan balik.

Nilai kembali

Jika fungsi gagal atau tidak dapat melakukan enumerasi, nilai yang dikembalikan adalah nol.

Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Anda harus memastikan bahwa fungsi panggilan balik mengatur SetLastError jika gagal.

Windows Server 2003 dan Windows XP/2000: Jika tidak ada jendela di desktop, GetLastError mengembalikan ERROR_INVALID_HANDLE.

Keterangan

Fungsi EnumDesktopWindows berulang kali memanggil fungsi panggilan balik lpfn hingga jendela tingkat atas terakhir dijumlahkan atau fungsi panggilan balik mengembalikan FALSE.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winuser.h (sertakan Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-windowstation-l1-1-0 (diperkenalkan dalam Windows 8)