EnumWindows-Funktion (winuser.h)

Artikel
03/04/2024

Listet alle Fenster der obersten Ebene auf dem Bildschirm auf, indem das Handle wiederum an jedes Fenster an eine anwendungsdefinierte Rückruffunktion übergeben wird. EnumWindows wird fortgesetzt, bis das letzte Fenster der obersten Ebene aufgelistet ist oder die Rückruffunktion FALSE zurückgibt.

Syntax

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

Parameter

[in] lpEnumFunc

Typ: WNDENUMPROC

Ein Zeiger auf eine anwendungsdefinierte Rückruffunktion. Weitere Informationen finden Sie unter EnumWindowsProc.

[in] lParam

Typ: LPARAM

Ein anwendungsdefinierter Wert, der an die Rückruffunktion übergeben werden soll.

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Wenn EnumWindowsProc null zurückgibt, ist auch der Rückgabewert 0. In diesem Fall sollte die Rückruffunktion SetLastError aufrufen, um einen aussagekräftigen Fehlercode abzurufen, der an den Aufrufer von EnumWindows zurückgegeben wird.

Hinweise

Die EnumWindows-Funktion listet keine untergeordneten Fenster auf, mit Ausnahme einiger Fenster der obersten Ebene, die dem System gehören, die den WS_CHILD Stil aufweisen.

Diese Funktion ist zuverlässiger als das Aufrufen der GetWindow-Funktion in einer Schleife. Eine Anwendung, die GetWindow aufruft, um diese Aufgabe auszuführen, riskiert, in einer Unendlichkeitsschleife abgefangen zu werden oder ein Handle auf ein fenster verweist, das zerstört wurde.

Hinweis Für Windows 8 und höher listet EnumWindows nur Fenster der obersten Ebene von Desktop-Apps auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-window-l1-1-0 (eingeführt in Windows 8)