EnumDesktopWindows-Funktion (winuser.h)
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) |