Funzione SetConsoleCP
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 |