FindWindowA-Funktion (winuser.h)

Artikel
11/20/2024

Ruft ein Handle für das Fenster der obersten Ebene ab, dessen Klassenname und Fenstername den angegebenen Zeichenfolgen entsprechen. Diese Funktion durchsucht keine untergeordneten Fenster. Diese Funktion führt keine Suche mit Groß-/Kleinschreibung durch.

Verwenden Sie die FindWindowEx--Funktion, um untergeordnete Fenster zu durchsuchen, beginnend mit einem angegebenen untergeordneten Fenster.

Syntax

HWND FindWindowA(
  [in, optional] LPCSTR lpClassName,
  [in, optional] LPCSTR lpWindowName
);

Parameter

[in, optional] lpClassName

Typ: LPCTSTR-

Der Klassenname oder ein Klassenatom, das von einem vorherigen Aufruf der RegisterClass oder RegisterClassEx--Funktion erstellt wurde. Das Atom muss sich im Wort "low-order" von lpClassName; Das Wort "Hochreihenfolge" muss null sein.

Wenn lpClassName auf eine Zeichenfolge zeigt, gibt sie den Namen der Fensterklasse an. Der Klassenname kann ein beliebiger Name sein, der mit RegisterClass oder RegisterClassEx-oder einem der vordefinierten Steuerelementklassennamen registriert ist.

Wenn lpClassName-NULL-ist, wird jedes Fenster gefunden, dessen Titel dem lpWindowName Parameter entspricht.

[in, optional] lpWindowName

Typ: LPCTSTR-

Der Fenstername (Der 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 dem angegebenen Klassennamen und Fensternamen.

Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL-. Diese Funktion ändert nicht den letzten Fehlerwert.

Bemerkungen

Wenn der parameter lpWindowName nicht NULList, ruft FindWindow die GetWindowText--Funktion auf, um den Fensternamen für den Vergleich abzurufen. Eine Beschreibung eines potenziellen Problems, das auftreten kann, finden Sie in den Anmerkungen zu GetWindowText.

Beispiele

Ein Beispiel finden Sie unter Abrufen der Anzahl der Mausrad-Bildlauflinien.

Anmerkung

Der winuser.h-Header definiert FindWindow 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 Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winuser.h (enthalten Windows.h)
Library	User32.lib
DLL-	User32.dll
API-Satz	ext-ms-win-ntuser-window-l1-1-0 (eingeführt in Windows 8)