SetConsoleScreenBufferInfoEx 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 Dokument klassische Konsole im Vergleich zum virtuellen Terminal.

Legt erweiterte Informationen zum angegebenen Konsolenbildschirmpuffer fest.

Syntax

BOOL WINAPI SetConsoleScreenBufferInfoEx(
  _In_ HANDLE                        hConsoleOutput,
  _In_ PCONSOLE_SCREEN_BUFFER_INFOEX lpConsoleScreenBufferInfoEx
);

Parameter

hConsoleOutput [in]
Ein Handle für den Konsolenbildschirm-Puffer. Das Handle muss das Zugriffsrecht GENERIC_WRITE besitzen. Weitere Informationen finden Sie unter Sicherheit und Zugriffsrechte für Konsolenpuffer.

lpConsoleScreenBufferInfoEx [in]
Eine CONSOLE_SCREEN_BUFFER_INFOEX Struktur, die die Informationen zum Konsolenbildschirmpuffer enthält.

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

Tipp

Diese API verfügt über eine teilweise virtuelle Terminal-Entsprechung. Cursorpositionierungspuffer und Textattribute weisen spezifische Sequenzentsprechungen auf. Die Farbtabelle ist nicht konfigurierbar, aber es stehen erweiterte Farben zur Verfügung, die über das hinausgehen, was normalerweise über die Konsolenfunktionen verfügbar ist. Popupattribute haben keine Entsprechung, da Popupmenüs die Verantwortung der Befehlszeilenclientanwendung in der virtuellen Terminal-Welt haben. Schließlich werden die Größe des Fensters und der Vollbildstatus als Berechtigungen betrachtet, die dem Benutzer in der virtuellen Terminal-Welt gehören und keine entsprechende Sequenz aufweisen.

Anforderungen

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

Siehe auch

Konsolenfunktionen

CONSOLE_SCREEN_BUFFER_INFOEX

GetConsoleScreenBufferInfoEx