GetParent-Funktion (winuser.h)

Artikel
08/27/2023

Ruft ein Handle an das übergeordnete Element oder den Besitzer des angegebenen Fensters ab.

Verwenden Sie die GetAncestor-Funktion , um ein Handle für einen angegebenen Vorgänger abzurufen.

Syntax

HWND GetParent(
  [in] HWND hWnd
);

Parameter

[in] hWnd

Typ: HWND

Ein Handle für das Fenster, dessen Übergeordnetes Fensterhandle abgerufen werden soll.

Rückgabewert

Typ: HWND

Wenn das Fenster ein untergeordnetes Fenster ist, ist der Rückgabewert ein Handle für das übergeordnete Fenster. Wenn es sich bei dem Fenster um ein Fenster auf oberster Ebene mit dem WS_POPUP Stil handelt, ist der Rückgabewert ein Handle für das Besitzerfenster.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Diese Funktion schlägt in der Regel aus einem der folgenden Gründe fehl:

Das Fenster ist ein Fenster auf oberster Ebene, das nicht vorhanden ist oder nicht über den WS_POPUP-Stil verfügt.
Das Besitzerfenster weist WS_POPUP Stil auf.

Hinweise

Verwenden Sie GetWindow mit dem Flag GW_OWNER, um das Besitzerfenster eines Fensters abzurufen, anstatt GetParent zu verwenden. Verwenden Sie GetAncestor mit dem flag GA_PARENT, um das übergeordnete Fenster und nicht den Besitzer zu erhalten, anstatt GetParent zu verwenden.

Beispiele

Ein Beispiel finden Sie unter Initialisieren eines Dialogfelds.

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-window-l1-1-0 (eingeführt in Windows 8)