Funzione SetConsoleOutputCP

  • Articolo

Imposta la tabella codici di output utilizzata dalla console associata al processo chiamante. Una console usa la tabella codici di output per convertire i valori di carattere scritti dalle varie funzioni di output nelle immagini visualizzate nella finestra della console.

Sintassi

BOOL WINAPI SetConsoleOutputCP(
  _In_ UINT wCodePageID
);

Parametri

wCodePageID [in]
Identificatore della tabella codici da impostare. Per altre informazioni, vedere la sezione Note.

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:

Una tabella codici esegue il mapping di 256 codici di carattere a singoli caratteri. Diverse tabelle codici contengono caratteri speciali differenti, in genere personalizzati per un linguaggio o per un gruppo di linguaggi.

Se il tipo di carattere corrente è un tipo di carattere Unicode a passo fisso, SetConsoleOutputCP modifica il mapping dei valori di carattere nel set di glifi del tipo di carattere, anziché caricare un tipo di carattere separato ogni volta che viene chiamato. Ciò influisce sul modo in cui i caratteri estesi (valore ASCII maggiore di 127) vengono visualizzati in una finestra della console. Tuttavia, se il tipo di carattere corrente è un tipo di carattere raster, SetConsoleOutputCP non influisce sulla modalità di visualizzazione dei caratteri estesi.

Per trovare le tabelle codici installate o supportate dal sistema operativo, utilizzare la funzione EnumSystemCodePages . Gli identificatori delle tabelle codici disponibili nel computer locale vengono archiviati anche nel Registro di sistema sotto la chiave seguente:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\CodePage

Tuttavia, è preferibile usare EnumSystemCodePages per enumerare le tabelle codici perché il Registro di sistema può differire in versioni diverse di Windows. Per determinare se una tabella codici specifica è valida, utilizzare la funzione IsValidCodePage . Per recuperare altre informazioni su una tabella codici, incluso il nome, usare la funzione GetCPInfoEx. Per un elenco degli identificatori della tabella codici disponibili, vedere Identificatori della tabella codici.

Per determinare la tabella codici di output corrente di una console, usare la funzione GetConsoleOutputCP. Per impostare e recuperare la tabella codici di input di una console, usare le funzioni SetConsoleCP e GetConsoleCP.

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

Tabelle codici della console

Funzioni della console

GetConsoleCP

GetConsoleOutputCP

SetConsoleCP