SetConsoleOutputCP関数

呼び出し元プロセスに関連付けられているコンソールによって使用される出力コード ページを設定します。 コンソールは、出力コード ページを使用して、さまざまな出力関数によって書き込まれた文字値を、コンソール ウィンドウに表示されるイメージに変換します。

構文

BOOL WINAPI SetConsoleOutputCP(
  _In_ UINT wCodePageID
);

パラメーター

wCodePageID [in]
設定するコードページの識別子。 詳細については、「解説」を参照してください。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

コード ページは、256 文字のコードを個々の文字にマップします。 異なるコード ページには異なる特殊文字が含まれ、それらは通常は 1 つの言語または言語グループ用にカスタマイズされています。

現在のフォントが固定ピッチ Unicode フォントの場合、 SetConsoleOutputCP は、呼び出されるたびに個別のフォントを読み込むのではなく、文字値のマッピングをフォントのグリフ セットに変更します。 これは、拡張文字 (127 より大きい ASCII 値) をコンソール ウィンドウに表示する方法に影響します。 ただし、現在のフォントがラスター フォントの場合、 SetConsoleOutputCP は拡張文字の表示方法に影響しません。

オペレーティング システムによってインストールまたはサポートされているコード ページを検索するには、EnumSystemCodePages関数を使用します。 ローカル コンピューターで使用できるコード ページの識別子も、次のキーの下のレジストリに格納されます。

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\CodePage

ただし、レジストリは異なるバージョンの Windows で異なる可能性があるため、EnumSystemCodePagesを使用してコード ページを列挙することをお勧めします。 特定のコード ページが有効かどうかを判断するには、IsValidCodePage関数を使用します。 コード ページに関する詳細情報 (名前を含む) を取得するには、GetCPInfoEx関数を使用します。 使用可能なコード ページ識別子の一覧については、「コード ページ識別子」を参照してください。

コンソールの現在の出力コード ページを確認するには、GetConsoleOutputCP関数を使用します。 コンソールの入力コード ページを設定および取得するには、SetConsoleCP 関数と GetConsoleCP 関数を使用します。

要件

サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー	ConsoleApi2.h（WinCon.h 経由、Windows.h を含む）
ライブラリ	Kernel32.lib
[DLL]	Kernel32.dll

関連項目

コンソールのコード ページ

コンソール関数

GetConsoleCP

GetConsoleOutputCP

SetConsoleCP