FindWindowA-Funktion (winuser.h)

Artikel
05/30/2024

Ruft ein Handle für das Fenster der obersten Ebene ab, dessen Klassenname und Fenstername den angegebenen Zeichenfolgen entsprechen. Diese Funktion sucht keine untergeordneten Fenster. Diese Funktion führt keine Suche nach 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 durch einen vorherigen Aufruf der RegisterClass - oder RegisterClassEx-Funktion erstellt wurde. Das Atom muss sich in der niedrigen Reihenfolge des Worts lpClassName befinden. Das Wort mit hoher Ordnung muss 0 (null) sein.

Wenn lpClassName auf eine Zeichenfolge zeigt, wird der Name der Fensterklasse angegeben. Der Klassenname kann ein beliebiger Name sein, der bei RegisterClass oder RegisterClassEx oder einem der vordefinierten Steuerelementklassennamen registriert ist.

Wenn lpClassNameNULL ist, wird ein beliebiges Fenster gefunden, dessen Titel mit dem lpWindowName-Parameter übereinstimmt.

[in, optional] lpWindowName

Typ: LPCTSTR

Der Name des Fensters (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, das über den angegebenen Klassennamen und den angegebenen Fensternamen verfügt.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Mit dieser Funktion wird der letzte Fehlerwert nicht geändert.

Hinweise

Wenn der lpWindowName-Parameter nicht NULL ist, 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 Hinweisen zu GetWindowText.

Beispiele

Ein Beispiel finden Sie unter Abrufen der Anzahl der Mausradlauflinien.

Hinweis

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
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)