Fungsi EnumWindows (winuser.h)

Artikel
03/13/2024

Menghitung semua jendela tingkat atas di layar dengan meneruskan handel ke setiap jendela, pada gilirannya, ke fungsi panggilan balik yang ditentukan aplikasi. EnumWindows berlanjut hingga jendela tingkat atas terakhir dijumlahkan atau fungsi panggilan balik mengembalikan FALSE.

Sintaks

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

Parameter

[in] lpEnumFunc

Jenis: WNDENUMPROC

Penunjuk ke fungsi panggilan balik yang ditentukan aplikasi. Untuk informasi selengkapnya, lihat EnumWindowsProc.

[in] lParam

Jenis: LPARAM

Nilai yang ditentukan aplikasi untuk diteruskan ke fungsi panggilan balik.

Nilai kembali

Jenis: BOOL

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Jika EnumWindowsProc mengembalikan nol, nilai yang dikembalikan juga nol. Dalam hal ini, fungsi panggilan balik harus memanggil SetLastError untuk mendapatkan kode kesalahan yang bermakna untuk dikembalikan ke pemanggil EnumWindows.

Keterangan

Fungsi EnumWindows tidak menghitung jendela anak, dengan pengecualian beberapa jendela tingkat atas yang dimiliki oleh sistem yang memiliki gaya WS_CHILD .

Fungsi ini lebih dapat diandalkan daripada memanggil fungsi GetWindow dalam perulangan. Aplikasi yang memanggil GetWindow untuk melakukan risiko tugas ini tertangkap dalam perulangan tak terbatas atau mereferensikan handel ke jendela yang telah dihancurkan.

Catatan Untuk Windows 8 dan yang lebih baru, EnumWindows hanya menghitung jendela tingkat atas aplikasi desktop.

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 (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-window-l1-1-0 (diperkenalkan dalam Windows 8)