SetConsoleOutputCP

呼び出し側プロセスに関連付けられたコンソールが使用する出力コードページを設定する。

SetConsoleOutputCP wCodePageID

wCodePageID : [int] 設定するコードページの識別子。詳細は備考を参照。

(プラグイン / モジュール : kernel32.dll)

解説

呼び出し側プロセスに関連付けられたコンソールが使用する出力コードページを設定する。

[戻り値]
関数が成功した場合、戻り値は非ゼロである。失敗した場合はゼロである。拡張エラー情報を取得するには
[**GetLastError**](/windows/win32/api/errhandlingapi/nf-errhandlingapi-getlasterror)
を呼び出す。

[備考]
コードページは 256
個の文字コードを個別の文字にマッピングする。コードページごとに異なる特殊文字が含まれ、通常は言語または言語グループに合わせてカスタマイズされている。現在のフォントが固定ピッチ
Unicode フォントの場合、**SetConsoleOutputCP**
は呼び出しごとに別のフォントをロードするのではなく、文字値からフォントのグリフセットへのマッピングを変更する。これはコンソールウィンドウでの拡張文字
(ASCII 値 127 超) の表示に影響する。ただし現在のフォントがラスタフォントの場合、**SetConsoleOutputCP**
は拡張文字の表示に影響しない。インストールまたはサポートされているコードページを調べるには
[EnumSystemCodePages](/windows/win32/api/winnls/nf-winnls-enumsystemcodepagesa)
を使用する。ローカルコンピュータで利用可能なコードページの識別子はレジストリの次のキーにも保存されている:
`HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\CodePage`。ただし
Windows バージョンによってレジストリは異なるため
[EnumSystemCodePages](/windows/win32/api/winnls/nf-winnls-enumsystemcodepagesa)
で列挙するほうがよい。特定のコードページが有効かを判定するには
[IsValidCodePage](/windows/win32/api/winnls/nf-winnls-isvalidcodepage)
を使用する。コードページ名を含む詳細情報を取得するには
[**GetCPInfoEx**](/windows/win32/api/winnls/nf-winnls-getcpinfoexa)
を使用する。利用可能なコードページ識別子の一覧は
[コードページ識別子](/windows/win32/intl/code-page-identifiers)
を参照。コンソールの現在の出力コードページを取得するには
[**GetConsoleOutputCP**](getconsoleoutputcp.md)
を使用する。入力コードページの設定・取得には [**SetConsoleCP**](setconsolecp.md) と
[**GetConsoleCP**](getconsolecp.md) を使用する。

情報