EnumLanguageGroupLocalesA 関数 (winnls.h)

指定した言語グループ内のロケールを列挙します。

メモカスタム ロケールの場合、アプリケーションでは EnumLanguageGroupLocales を優先して EnumSystemLocalesEx を呼び出す必要があります。

 

構文

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

関連項目

EnumLanguageGroupLocalesProc

EnumSystemLanguageGroups

EnumSystemLocalesEx

IsValidLanguageGroup

各国語サポート

各国語サポート関数