EnumDesktopWindows-Funktion (winuser.h)

Artikel
08/27/2023

Listet alle Fenster der obersten Ebene auf, die dem angegebenen Desktop zugeordnet sind. Das Handle wird wiederum an jedes Fenster an eine anwendungsdefinierte Rückruffunktion übergeben.

Syntax

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

Parameter

[in, optional] hDesktop

Ein Handle für den Desktop, dessen Fenster auf oberster Ebene aufgelistet werden sollen. Dieses Handle wird von der Funktion CreateDesktop, GetThreadDesktop, OpenDesktop oder OpenInputDesktop zurückgegeben und muss über das DESKTOP_READOBJECTS-Zugriffsrecht verfügen. Weitere Informationen finden Sie unter Desktopsicherheit und -zugriffsrechte.

Wenn dieser Parameter NULL ist, wird der aktuelle Desktop verwendet.

[in] lpfn

Ein Zeiger auf eine anwendungsdefinierte EnumWindowsProc-Rückruffunktion .

[in] lParam

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

Rückgabewert

Wenn die Funktion fehlschlägt oder die Enumeration nicht ausführen kann, ist der Rückgabewert null.

Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Sie müssen sicherstellen, dass die Rückruffunktion SetLastError festlegt, wenn sie fehlschlägt.

Windows Server 2003 und Windows XP/2000: Wenn auf dem Desktop keine Fenster vorhanden sind, gibt GetLastErrorERROR_INVALID_HANDLE zurück.

Hinweise

Die EnumDesktopWindows-Funktion ruft die lpfn-Rückruffunktion wiederholt auf, bis das letzte Fenster der obersten Ebene aufgelistet ist oder die Rückruffunktion FALSE zurückgibt.

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 (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-windowstation-l1-1-0 (eingeführt in Windows 8)