FindWindowExW-Funktion (winuser.h)

Artikel
08/27/2023

Ruft ein Handle für ein Fenster ab, dessen Klassenname und Fenstername mit den angegebenen Zeichenfolgen übereinstimmen. Die Funktion durchsucht untergeordnete Fenster, beginnend mit dem Fenster, das dem angegebenen untergeordneten Fenster folgt. Diese Funktion führt keine Suche zwischen Groß- und Kleinschreibung durch.

Syntax

HWND FindWindowExW(
  [in, optional] HWND    hWndParent,
  [in, optional] HWND    hWndChildAfter,
  [in, optional] LPCWSTR lpszClass,
  [in, optional] LPCWSTR lpszWindow
);

Parameter

[in, optional] hWndParent

Typ: HWND

Ein Handle für das übergeordnete Fenster, dessen untergeordnete Fenster durchsucht werden sollen.

Wenn hwndParentNULL ist, verwendet die Funktion das Desktopfenster als übergeordnetes Fenster. Die Funktion sucht zwischen Fenstern, die untergeordnete Fenster des Desktops sind.

Wenn hwndParentHWND_MESSAGE ist, durchsucht die Funktion alle Nur-Nachrichtenfenster.

[in, optional] hWndChildAfter

Typ: HWND

Ein Handle für ein untergeordnetes Fenster. Die Suche beginnt mit dem nächsten untergeordneten Fenster in der Reihenfolge Z. Das untergeordnete Fenster muss ein direktes untergeordnetes Fenster von hwndParent sein, nicht nur ein untergeordnetes Fenster.

Wenn hwndChildAfterNULL ist, beginnt die Suche mit dem ersten untergeordneten Fenster von hwndParent.

Wenn sowohl hwndParent als auch hwndChildAfterNULL sind, durchsucht die Funktion alle Fenster der obersten Ebene und nur Nachrichtenfenster.

[in, optional] lpszClass

Typ: LPCWSTR

Der Klassenname oder ein Klassenatom, das durch einen vorherigen Aufruf der Funktion RegisterClass oder RegisterClassEx erstellt wurde. Das Atom muss im Wort "lpszClass" in niedriger Reihenfolge platziert werden. das wort mit hoher Ordnung muss 0 sein.

Wenn lpszClass eine Zeichenfolge ist, gibt sie den Namen der Fensterklasse an. Der Klassenname kann ein beliebiger Name sein, der bei RegisterClass oder RegisterClassEx registriert ist, oder jeder der vordefinierten Steuerelementklassennamen, oder er kann sein MAKEINTATOM(0x8000). In diesem letzteren Fall ist 0x8000 das Atom für eine Menüklasse. Weitere Informationen finden Sie in diesem Thema im Abschnitt „Hinweise“.

[in, optional] lpszWindow

Typ: LPCWSTR

Der Fenstername (Titel des Fensters). Wenn dieser Parameter NULL ist, stimmen alle Fensternamen überein.

Rückgabewert

Typ: HWND

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für das Fenster mit den angegebenen Klassen- und Fensternamen.

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

Hinweise

Die FindWindowEx-Funktion durchsucht nur direkte untergeordnete Fenster. Andere untergeordnete Elemente werden nicht durchsucht.

Wenn der lpszWindow-Parameter nicht NULL ist, ruft FindWindowEx die GetWindowText-Funktion auf, um den Fensternamen zum Vergleich abzurufen. Eine Beschreibung eines potenziellen Problems, das auftreten kann, finden Sie im Abschnitt Hinweise von GetWindowText.

Eine Anwendung kann diese Funktion wie folgt aufrufen.

FindWindowEx( NULL, NULL, MAKEINTATOM(0x8000), NULL );

Beachten Sie, dass 0x8000 das Atom für eine Menüklasse ist. Wenn eine Anwendung diese Funktion aufruft, überprüft die Funktion, ob ein Kontextmenü angezeigt wird, das von der Anwendung erstellt wurde.

Hinweis

Der winuser.h-Header definiert FindWindowEx als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

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-1 (eingeführt in Windows 8.1)