Funzione SetConsoleScreenBufferSize

Importante

Questo documento descrive le funzionalità della piattaforma della console che non fanno più parte della roadmap dell'ecosistema. Non è consigliabile usare questo contenuto nei nuovi prodotti, ma continueremo a supportare gli utilizzi esistenti per il futuro indefinito. La soluzione moderna preferita è incentrata sulle sequenze di terminale virtuale per garantire la massima compatibilità negli scenari multipiattaforma. Per altre informazioni su questa decisione di progettazione, vedere il documento relativo alla console classica e al terminale virtuale.

Modifica le dimensioni del buffer dello schermo della console specificato.

Sintassi

BOOL WINAPI SetConsoleScreenBufferSize(
  _In_ HANDLE hConsoleOutput,
  _In_ COORD  dwSize
);

Parametri

hConsoleOutput [in]
Handle per il buffer dello schermo della console. L'handle deve avere il diritto di accesso GENERIC_READ . Per altre informazioni, vedere Sicurezza dei buffer della console e diritti di accesso.

dwSize [in]
Struttura COORD che specifica le nuove dimensioni del buffer dello schermo della console, in righe e colonne di caratteri. La larghezza e l'altezza specificate non possono essere inferiori alla larghezza e all'altezza della finestra del buffer dello schermo della console. Le dimensioni specificate non possono anche essere inferiori alle dimensioni minime consentite dal sistema. Questo minimo dipende dalle dimensioni correnti del carattere per la console (selezionata dall'utente) e dai valori SM_CXMIN e SM_CYMIN restituiti dalla funzione GetSystemMetrics .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Osservazioni:

Suggerimento

Questa API non è consigliata e non ha un terminale virtuale equivalente. Questa decisione allinea intenzionalmente la piattaforma Windows ad altri sistemi operativi in cui all'utente viene concesso il controllo completo su questa opzione di presentazione. Le applicazioni remote tramite utilità multipiattaforma e trasporti come SSH potrebbero non funzionare come previsto se si usa questa API.

Requisiti

Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	ConsoleApi2.h (tramite WinCon.h, includere Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedi anche

Funzioni della console

Buffer di input della console

COORD

GetConsoleScreenBufferInfo

SetConsoleWindowInfo