次の方法で共有


EnumSystemLocalesEx 関数 (winnls.h)

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

アプリケーションは、Windows Vista 以降でのみ実行するように設計されている場合は、EnumSystemLocales する場合に優先してこの関数を呼び出す必要があります。
 

構文

BOOL EnumSystemLocalesEx(
  [in]           LOCALE_ENUMPROCEX lpLocaleEnumProcEx,
  [in]           DWORD             dwFlags,
  [in]           LPARAM            lParam,
  [in, optional] LPVOID            lpReserved
);

パラメーター

[in] lpLocaleEnumProcEx

アプリケーション定義コールバック関数へのポインター。 EnumSystemLocalesEx 関数は、このコールバック関数を繰り返し呼び出すことによってロケールを列挙します。 詳細については、「EnumLocalesProcEx を参照してください。

[in] dwFlags

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

[in] lParam

コールバック関数に渡されるアプリケーション指定のパラメーター。 これは、マルチスレッド アプリケーションに特に役立ちます。

[in, optional] lpReserved

引っ込み思案;は NULL する必要があります。

戻り値

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

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

備考

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

dwFlags パラメーターの選択肢は、インストールされているロケールとサポートされているロケールを区別する必要がある、EnumSystemLocalesの場合とは異なります。

dwFlags LOCALE_ALTERNATE_SORTSを指定すると、代替の並べ替え順序を表すロケールごとにコールバック関数が呼び出されます。 たとえば、スペイン語 (スペイン) は既定で国際並べ替え順序ですが、代替の並べ替えでは従来の並べ替え順序を使用できます。 ドイツ語 (ドイツ) は既定で辞書の並べ替え順序ですが、代替の電話帳の並べ替え順序を使用できます。

この関数の使用方法を示す例は、NLS: 名前ベースの API サンプルにあります。

必要条件

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

関連項目

EnumLocalesProcEx

EnumSystemLocales

各国語サポート

各国語サポート関数