Freigeben über


GetTopWindow-Funktion (winuser.h)

Untersucht die Z-Reihenfolge der untergeordneten Fenster, die dem angegebenen übergeordneten Fenster zugeordnet sind, und ruft ein Handle für das untergeordnete Fenster am oberen Rand der Z-Reihenfolge ab.

Syntax

HWND GetTopWindow(
  [in, optional] HWND hWnd
);

Parameter

[in, optional] hWnd

Typ: HWND

Ein Handle für das übergeordnete Fenster, dessen untergeordnete Fenster untersucht werden sollen. Wenn dieser Parameter NULL ist, gibt die Funktion ein Handle an das Fenster am anfang der Z-Reihenfolge zurück.

Rückgabewert

Typ: HWND

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für das untergeordnete Fenster am Anfang der Z-Reihenfolge. Wenn das angegebene Fenster keine untergeordneten Fenster enthält, ist der Rückgabewert NULL. Verwenden Sie die GetLastError-Funktion , um erweiterte Fehlerinformationen abzurufen.

Anforderungen

   
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-4 (eingeführt in Windows 10, Version 10.0.14393)

Siehe auch

Konzept

GetNextWindow

GetWindow

Referenz

Windows