Funzione SetConsoleScreenBufferInfoEx
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.
Imposta informazioni estese sul buffer dello schermo della console specificato.
Sintassi
BOOL WINAPI SetConsoleScreenBufferInfoEx(
_In_ HANDLE hConsoleOutput,
_In_ PCONSOLE_SCREEN_BUFFER_INFOEX lpConsoleScreenBufferInfoEx
);
Parametri
hConsoleOutput [in]
Handle per il buffer dello schermo della console. L'handle deve avere il diritto di accesso GENERIC_WRITE . Per altre informazioni, vedere Sicurezza dei buffer della console e diritti di accesso.
lpConsoleScreenBufferInfoEx [in]
Struttura CONSOLE_SCRedizione EnterpriseN_BUFFER_INFOEX che contiene le informazioni sul buffer dello schermo della console.
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 ha un terminale virtuale parziale equivalente. Il buffer di posizionamento del cursore e gli attributi di testo hanno equivalenti di sequenza specifici. La tabella dei colori non è configurabile, ma i colori estesi sono disponibili oltre a quello normalmente disponibile tramite le funzioni della console. Gli attributi popup non hanno un equivalente come menu popup sono responsabili dell'applicazione client della riga di comando nel mondo del terminale virtuale. Infine, le dimensioni della finestra e lo stato a schermo intero sono considerati privilegi di proprietà dell'utente nel mondo del terminale virtuale e non hanno sequenza equivalente.
Requisiti
Client minimo supportato | Windows Vista [solo app desktop] |
Server minimo supportato | Windows Server 2008 [solo app desktop] |
Intestazione | ConsoleApi2.h (tramite WinCon.h, includere Windows.h) |
Libreria | Kernel32.lib |
DLL | Kernel32.dll |