FindWindowA-Funktion (winuser.h)
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) |
Siehe auch
Konzept
Referenz
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für