EnumLanguageGroupLocalesA 函数 (winnls.h)

枚举指定语言组中的区域设置。

注意 对于自定义区域设置,应用程序应优先调用 EnumSystemLocalesEx,而不是 EnumLanguageGroupLocales

 

语法

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。 若要获取扩展的错误信息,应用程序可以调用 GetLastError,这会返回以下错误代码之一:

  • ERROR_BADDB。 该函数无法访问数据。 这种情况通常不应发生,通常表示安装错误、磁盘问题或类似情况。
  • ERROR_INVALID_FLAGS。 为标志提供的值无效。
  • ERROR_INVALID_PARAMETER。 任何参数值都无效。

言论

此函数通过将区域设置标识符(一次一个)传递给应用程序定义的回调函数来枚举指定语言组中的区域设置。 此过程一直持续到 EnumLanguageGroupLocales 查找最后一个区域设置标识符或回调函数返回 FALSE

注意

winnls.h 标头将 EnumLanguageGroupLocales 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 winnls.h (包括 Windows.h)
Kernel32.lib
DLL Kernel32.dll

另请参阅

EnumLanguageGroupLocalesProc

EnumSystemLanguageGroups

EnumSystemLocalesEx

IsValidLanguageGroup

国家语言支持

国家语言支持函数