Freigeben über


GetConsoleScreenBufferInfo Funktion

Ruft Informationen über die angegebene Bildlaufleiste ab.

Syntax

BOOL WINAPI GetConsoleScreenBufferInfo(
  _In_  HANDLE                      hConsoleOutput,
  _Out_ PCONSOLE_SCREEN_BUFFER_INFO lpConsoleScreenBufferInfo
);

Parameter

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

lpConsoleScreenBufferInfo [out]
Ein Zeiger auf eine CONSOLE_SCREEN_BUFFER_INFO Struktur, die die Informationen zum Konsolenbildschirmpuffer empfängt.

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

Das im srWindow-Element der CONSOLE_SCREEN_BUFFER_INFO Struktur zurückgegebene Rechteck kann geändert und dann an die SetConsoleWindowInfo-Funktion übergeben werden, um im Fenster zu scrollen, um die Größe des Fensters oder beides zu ändern.

Alle in der CONSOLE_SCREEN_BUFFER_INFO Struktur zurückgegebenen Koordinaten befinden sich in Zeichenzellenkoordinaten, wobei sich der Ursprung (0, 0) in der oberen linken Ecke des Konsolenbildschirmpuffers befindet.

Tipp

Diese API verfügt nicht über ein virtuelles Terminaläquivalent. Die Verwendung ist möglicherweise weiterhin für Anwendungen erforderlich, die versuchen, Spalten, Raster zu zeichnen oder die Anzeige auszufüllen, um die Fenstergröße abzurufen. Dieser Fensterzustand wird von der TTY/PTY/Pseudoconsole außerhalb des normalen Datenstromflusses verwaltet und gilt im Allgemeinen als Benutzerberechtigungen, die von der Clientanwendung nicht anpassbar sind. Updates können auf ReadConsoleInput empfangen werden.

Beispiele

Ein Beispiel finden Sie unter Scrollen des Fensters eines Bildschirmpuffers.

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

CONSOLE_SCREEN_BUFFER_INFO

GetLargestConsoleWindowSize

SetConsoleCursorPosition

SetConsoleScreenBufferSize

SetConsoleWindowInfo

Puffergröße von Fenster und Bildschirm