EnumSystemLocalesW 関数 (winnls.h)
オペレーティング システムにインストールされているか、オペレーティング システムによってサポートされているロケールを列挙します。
構文
BOOL EnumSystemLocalesW(
[in] LOCALE_ENUMPROCW lpLocaleEnumProc,
[in] DWORD dwFlags
);
パラメーター
[in] lpLocaleEnumProc
アプリケーション定義のコールバック関数へのポインター。 詳細については、「 EnumLocalesProc」を参照してください。
[in] dwFlags
列挙するロケール識別子を指定するフラグ。 フラグは、単独で使用することも、バイナリ OR を使用して組み合わせて使用することもできます。 アプリケーションでこのパラメーターに 0 を指定した場合、関数は LCID_SUPPORTED と同様に動作します。
戻り値
成功した場合は 0 以外の値を返し、それ以外の場合は 0 を返します。 拡張エラー情報を取得するために、アプリケーションは GetLastError を呼び出すことができます。これにより、次のいずれかのエラー コードが返されます。
- ERROR_BADDB。 関数がデータにアクセスできませんでした。 この状況は通常は発生しません。通常は、インストールが正しくない、ディスクの問題などを示します。
- ERROR_INVALID_FLAGS。 フラグに指定された値が無効でした。
- ERROR_INVALID_PARAMETER。 パラメーター値のいずれかが無効です。
注釈
関数は、ロケール識別子を一度に 1 つずつ、指定されたアプリケーション定義のコールバック関数に渡すことによってロケールを列挙します。 これは、インストールまたはサポートされているすべてのロケール識別子がコールバック関数に渡されるか、コールバック関数が FALSE を返すまで続きます。
注意
winnls.h ヘッダーは EnumSystemLocales をエイリアスとして定義します。このエイリアスは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | winnls.h (Windows.h を含む) |
Library | Kernel32.lib |
[DLL] | Kernel32.dll |