次の方法で共有

EnumSystemLocalesA 関数 (winnls.h)

  • [アーティクル]

オペレーティング システムにインストールされているか、オペレーティング システムでサポートされているロケールを列挙します。

メモ 相互運用性の理由から、アプリケーションは EnumSystemLocalesEx 関数 を使用して EnumSystemLocales を する必要があります。これは、Microsoft が新しいロケールのロケール識別子ではなくロケール名の使用に移行するためです。 Windows Vista 以降でのみ実行されるアプリケーションは、EnumSystemLocalesEx使用する必要があります。
 

構文

BOOL EnumSystemLocalesA(
  [in] LOCALE_ENUMPROCA lpLocaleEnumProc,
  [in] DWORD            dwFlags
);

パラメーター

[in] lpLocaleEnumProc

アプリケーション定義コールバック関数へのポインター。 詳細については、「EnumLocalesProc 」を参照してください。

[in] dwFlags

列挙するロケール識別子を指定するフラグ。 フラグは、単独で使用することも、バイナリ OR を使用して組み合わせて使用することもできます。 アプリケーションでこのパラメーターに 0 を指定した場合、関数はLCID_SUPPORTEDと同様に動作します。

価値 意味
LCID_INSTALLED
 インストールされているロケール識別子のみを列挙します。 この値は、LCID_SUPPORTEDでは使用できません。
LCID_SUPPORTED
 サポートされているすべてのロケール識別子を列挙します。 この値は、LCID_INSTALLEDでは使用できません。
LCID_ALTERNATE_SORTS
 代替並べ替えロケール識別子のみを列挙します。 この値をLCID_INSTALLEDまたはLCID_SUPPORTEDで使用すると、インストールされているロケールまたはサポートされているロケールと、代替の並べ替えロケール識別子が取得されます。

戻り値

成功した場合は 0 以外の値を返し、それ以外の場合は 0 を返します。 拡張エラー情報を取得するために、アプリケーションは GetLastError呼び出すことができます。これは、次のいずれかのエラー コードを返すことができます。

  • ERROR_BADDB。 関数がデータにアクセスできませんでした。 この状況は、通常は発生するべきではありません。また、通常は、不適切なインストール、ディスクの問題などを示します。
  • ERROR_INVALID_FLAGS。 フラグに指定された値が無効でした。
  • ERROR_INVALID_PARAMETER。 パラメーター値のいずれかが無効でした。

備考

この関数は、ロケール識別子を一度に 1 つずつ、指定されたアプリケーション定義コールバック関数に渡すことによってロケールを列挙します。 これは、インストールまたはサポートされているすべてのロケール識別子がコールバック関数に渡されるか、コールバック関数から FALSE返されるまで続行されます。

手記

winnls.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして EnumSystemLocales を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー winnls.h (Windows.h を含む)
ライブラリ Kernel32.lib
DLL Kernel32.dll

関連項目

EnumLocalesProc の

EnumSystemLocalesEx の

各国語サポート

各国語サポート関数