EnumLanguageGroupLocalesA 関数 (winnls.h)
指定した言語グループ内のロケールを列挙します。
構文
BOOL EnumLanguageGroupLocalesA(
[in] LANGGROUPLOCALE_ENUMPROCA lpLangGroupLocaleEnumProc,
[in] LGRPID LanguageGroup,
[in] DWORD dwFlags,
[in] LONG_PTR lParam
);
パラメーター
[in] lpLangGroupLocaleEnumProc
アプリケーション定義のコールバック関数へのポインター。 詳細については、「 EnumLanguageGroupLocalesProc」を参照してください。
[in] LanguageGroup
ロケールを列挙する言語グループの識別子。 このパラメーターには、次のいずれかの値を指定できます。
- LGRPID_ARABIC
- LGRPID_ARMENIAN
- LGRPID_BALTIC
- LGRPID_CENTRAL_EUROPE
- LGRPID_CYRILLIC
- LGRPID_GEORGIAN
- LGRPID_GREEK
- LGRPID_HEBREW
- LGRPID_INDIC
- LGRPID_JAPANESE
- LGRPID_KOREAN
- LGRPID_SIMPLIFIED_CHINESE
- LGRPID_TRADITIONAL_CHINESE
- LGRPID_THAI
- LGRPID_TURKIC
- LGRPID_TURKISH
- LGRPID_VIETNAMESE
- LGRPID_WESTERN_EUROPE
[in] dwFlags
予約;は 0 である必要があります。
[in] lParam
コールバック関数に渡すアプリケーション定義値。 この値は、エラー チェックに使用できます。 また、コールバック関数のスレッド セーフを確保するためにも使用できます。
戻り値
成功した場合は 0 以外の値を返し、それ以外の場合は 0 を返します。 拡張エラー情報を取得するために、アプリケーションは GetLastError を呼び出すことができます。このエラー コードは、次のいずれかのエラー コードを返すことができます。
- ERROR_BADDB。 関数がデータにアクセスできませんでした。 この状況は、通常は発生するべきではありません。通常は、インストールが正しくないことを示します。ディスクの問題などです。
- ERROR_INVALID_FLAGS。 フラグに指定された値が無効です。
- ERROR_INVALID_PARAMETER。 パラメーター値のいずれかが無効です。
解説
この関数は、ロケール識別子をアプリケーション定義のコールバック関数に一度に 1 つずつ渡すことによって、指定された言語グループ内のロケールを列挙します。 このプロセスは、 EnumLanguageGroupLocales が最後のロケール識別子を検出するか、コールバック関数が FALSE を返すまで続行されます。
注意
winnls.h ヘッダーは、EnumLanguageGroupLocales をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winnls.h (Windows.h を含む) |
| Library | Kernel32.lib |
| [DLL] | Kernel32.dll |