FindWindowA-Funktion (winuser.h)

Artikel
08/27/2023

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

Um untergeordnete Fenster zu durchsuchen, verwenden Sie ab einem angegebenen untergeordneten Fenster die FindWindowEx-Funktion .

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 Funktion RegisterClass oder RegisterClassEx erstellt wurde. Das Atom muss sich in der niedrigen Reihenfolge des Worts lpClassName befinden. das wort mit hoher Ordnung muss 0 sein.

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

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

[in, optional] lpWindowName

Typ: LPCTSTR

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

Wenn der lpWindowName-Parameter nicht NULL ist, ruft FindWindow die GetWindowText-Funktion auf, um den Fensternamen zum Vergleich abzurufen. Eine Beschreibung eines potenziellen Problems, das auftreten kann, finden Sie in den Hinweise 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 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-0 (eingeführt in Windows 8)