Funzione SetConsoleScreenBufferInfoEx

  • Articolo

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

Vedi anche

Funzioni della console

CONSOLE_SCRedizione EnterpriseN_BUFFER_INFOEX

GetConsoleScreenBufferInfoEx