GetCPInfoExA 関数 (winnls.h)
インストールされている有効なコード ページまたは使用可能なコード ページに関する情報を取得します。
構文
BOOL GetCPInfoExA(
[in] UINT CodePage,
[in] DWORD dwFlags,
[out] LPCPINFOEXA lpCPInfoEx
);
パラメーター
[in] CodePage
情報を取得するコード ページの識別子。 アプリケーションでは、インストールされているコード ページまたは使用可能なコード ページのコード ページ識別子、または次の定義済みの値のいずれかを指定できます。 ANSI およびその他 のコード ページの 識別子の一覧については、「コード ページ識別子」を参照してください。
| 値 | 意味 |
|---|---|
|
システムの既定の Windows ANSI コード ページを使用します。 |
|
システムの既定の Macintosh コード ページを使用します。 |
|
システムの既定の OEM コード ページを使用します。 |
|
現在のスレッドの ANSI コード ページを使用します。 |
[in] dwFlags
予約;は 0 である必要があります。
[out] lpCPInfoEx
コード ページに関する情報を受け取る CPINFOEX 構造体へのポインター。
戻り値
成功した場合は 0 以外の値を返し、それ以外の場合は 0 を返します。 拡張エラー情報を取得するために、アプリケーションは GetLastError を呼び出すことができます。これにより、次のいずれかのエラー コードが返されます。
- ERROR_INVALID_PARAMETER。 パラメーター値のいずれかが無効です。
注釈
CPINFOEX 構造体で取得された情報は、すべてのコード ページで必ずしも役立つとは限りません。 たとえば、バッファー サイズを決定するには、アプリケーションで MultiByteToWideChar または WideCharToMultiByte を呼び出して、正確なバッファー サイズを要求する必要があります。 CPINFOEX 設定でリード バイトが存在することを示している場合、変換関数は必ずしもリード バイトを異なる方法で処理するとは限りません。たとえば、不足している証跡バイトや無効な証跡バイトの場合などです。
注意
winnls.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GetCPInfoEx を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winnls.h (Windows.h を含む) |
| Library | Kernel32.lib |
| [DLL] | Kernel32.dll |