EnumSystemLocalesEx

OS にインストールされている、または OS がサポートしているロケールを列挙する。注: Windows Vista 以降でのみ動作するように設計されている場合、アプリケーションは EnumSystemLocales よりもこの関数を呼び出すべきである。

EnumSystemLocalesEx lpLocaleEnumProcEx, dwFlags, lParam, lpReserved

lpLocaleEnumProcEx : [int] アプリケーション定義のコールバック関数へのポインタ。EnumSystemLocalesEx 関数はこのコールバック関数を繰り返し呼ぶことでロケールを列挙する。詳細は EnumLocalesProcEx を参照。
dwFlags : [int] 列挙するロケールを識別するフラグ。フラグは単独でも、バイナリ OR で結合しても使用できる。アプリケーションがこのパラメータに 0 を指定した場合、関数は LOCALE_ALL の場合と同様に動作する。
lParam : [intptr] コールバック関数に渡すアプリケーション提供のパラメータ。これはマルチスレッドアプリケーションで特に有用である。
lpReserved : [intptr] 予約。NULL でなければならない。

(プラグイン / モジュール : kernel32.dll)

解説

OS にインストールされている、または OS がサポートしているロケールを列挙する。注: Windows Vista
以降でのみ動作するように設計されている場合、アプリケーションは EnumSystemLocales よりもこの関数を呼び出すべきである。

[戻り値]
成功した場合 0 以外、それ以外の場合 0 を返す。拡張エラー情報を取得するには、アプリケーションは GetLastError
を呼ぶことができ、次のいずれかのエラーコードを返すことがある。
(以下省略)

[備考]
この関数は、ロケール名を 1 つずつ lpLocaleEnumProcEx
で指定されたアプリケーション定義のコールバック関数に渡してロケールを列挙する。列挙は、インストール済みまたはサポートされているすべての名前がコールバック関数に渡されるか、コールバック関数が
FALSE を返すまで続く。dwFlags パラメータの選択肢は、インストール済みとサポート済みのロケールを区別する必要がある
EnumSystemLocales のものとは異なる。dwFlags が LOCALE_ALTERNATE_SORTS
を指定する場合、コールバック関数は代替ソート順を表すすべてのロケールに対して呼ばれる。たとえば、Spanish (Spain)
は国際ソート順をデフォルトとするが、伝統的なソート順を代替ソートとして利用できる。German (Germany)
は辞書ソート順をデフォルトとするが、電話帳ソート順という代替がある。

情報

プラグイン / モジュールkernel32.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の kernel32.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_kernel32_gen2.hs