SetConsoleActiveScreenBuffer

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 .

Legt den angegebenen Bildschirmpuffer auf den aktuell angezeigten Konsolenbildschirmpuffer fest.

Syntax

BOOL WINAPI SetConsoleActiveScreenBuffer(
  _In_ HANDLE hConsoleOutput
);

Parameter

hConsoleOutput [in]
Ein Handle für den Konsolenbildschirm-Puffer.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Eine Konsole kann über mehrere Bildschirmpuffer verfügen. SetConsoleActiveScreenBuffer bestimmt, welche angezeigt wird. Sie können in einen inaktiven Bildschirmpuffer schreiben und dann SetConsoleActiveScreenBuffer verwenden, um den Inhalt des Puffers anzuzeigen.

Tipp

Diese API wird nicht empfohlen, verfügt aber über eine ungefähre virtuelle Terminalentsprechung in der alternativen Bildschirmpuffersequenz. Das Festlegen des alternativen Bildschirmpuffers kann einer Anwendung einen separaten, isolierten Bereich zum Zeichnen über die Sitzungslaufzeit bereitstellen und gleichzeitig den Inhalt beibehalten, der vom Aufrufer der Anwendung angezeigt wurde. Dadurch Standard enthält das Zeichnen von Informationen für die einfache Wiederherstellung beim Beenden des Prozesses.

Beispiele

Lesen und Schreiben von Zeichen- und Attributblöcken

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

Konsolenbildschirmpuffer

CreateConsoleScreenBuffer