GetConsoleWindow-Funktion

  • Artikel

Wichtig

In diesem Dokument werden Konsolenplattformfunktionen beschrieben, die nicht mehr Teil unserer Ökosystem-Roadmap sind. Wir empfehlen nicht, diesen Inhalt in neuen Produkten zu verwenden, aber wir werden weiterhin vorhandene Nutzungen für die unbegrenzte Zukunft unterstützen. Unsere bevorzugte moderne Lösung konzentriert sich auf virtuelle Terminalsequenzen für maximale Kompatibilität in plattformübergreifenden Szenarien. Weitere Informationen zu dieser Designentscheidung finden Sie in unserem klassischen Konsolendokument im Vergleich zum virtuellen Terminal .

Ruft das Fensterhandle ab, das von der Konsole verwendet wird, die dem aufrufenden Prozess zugeordnet ist.

Syntax

HWND WINAPI GetConsoleWindow(void);

Parameter

Diese Funktion besitzt keine Parameter.

Rückgabewert

Der Rückgabewert ist ein Handle für das Fenster, das von der Konsole verwendet wird, die dem aufrufenden Prozess zugeordnet ist, oder NULL , wenn keine solche zugeordnete Konsole vorhanden ist.

Hinweise

Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0500 oder höher. Weitere Informationen finden Sie unter Verwenden der Windows-Header.

Tipp

Diese API wird nicht empfohlen und verfügt nicht über eine virtuelle Terminalentsprechung. Diese Entscheidung richtet die Windows-Plattform absichtlich mit anderen Betriebssystemen aus. Dieser Zustand ist nur für den lokalen Benutzer-, Sitzungs- und Berechtigungskontext relevant. Anwendungen, die über plattformübergreifende Dienstprogramme und Transporte wie SSH remoten, funktionieren möglicherweise nicht wie erwartet, wenn Sie diese API verwenden.

Bei einer Anwendung, die in einer Pseudoconsole-Sitzung gehostet wird, gibt diese Funktion nur für Nachrichtenwarteschlangenzwecke ein Fensterhandle zurück. Das zugeordnete Fenster wird nicht lokal angezeigt, da die Pseudoconsole alle Aktionen für einen Datenstrom für die Präsentation an einer anderen Stelle serialisiert.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Header ConsoleApi.h (über WinCon.h, Windows.h einschließen)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

Konsolenfunktionen