EnumLanguageGroupLocalesA 函数 (winnls.h)

项目
08/27/2023

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

注意对于自定义区域设置，应用程序应调用 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 [仅限桌面应用]
目标平台	Windows
标头	winnls.h (包括 Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll