Funzione SetConsoleCP

  • Articolo

Imposta la tabella codici di input utilizzata dalla console associata al processo chiamante. Una console usa la tabella codici di input per convertire l'input della tastiera nel valore di carattere corrispondente.

Sintassi

BOOL WINAPI SetConsoleCP(
  _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.

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 input corrente di una console, usare la funzione GetConsoleCP. Per impostare e recuperare la tabella codici di output di una console, usare le funzioni SetConsoleOutputCP e GetConsoleOutputCP.

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

SetConsoleOutputCP