GetCPInfoExA 関数 (winnls.h)

  • [アーティクル]

インストールされている有効なコード ページまたは使用可能なコード ページに関する情報を取得します。

構文

BOOL GetCPInfoExA(
  [in]  UINT        CodePage,
  [in]  DWORD       dwFlags,
  [out] LPCPINFOEXA lpCPInfoEx
);

パラメーター

[in] CodePage

情報を取得するコード ページの識別子。 アプリケーションでは、インストールされているコード ページまたは使用可能なコード ページのコード ページ識別子、または次の定義済みの値のいずれかを指定できます。 ANSI およびその他 のコード ページの 識別子の一覧については、「コード ページ識別子」を参照してください。

値 意味
CP_ACP
 システムの既定の Windows ANSI コード ページを使用します。
CP_MACCP
 システムの既定の Macintosh コード ページを使用します。
CP_OEMCP
 システムの既定の OEM コード ページを使用します。
CP_THREAD_ACP
 現在のスレッドの 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

関連項目

CPINFOEX

GetACP

GetCPInfo

GetOEMCP

各国語サポート

各国語サポート関数