enumSystemLanguageGroupsW 函数 (winnls.h)

枚举安装在操作系统上或受操作系统支持的语言组。

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

 

语法

BOOL EnumSystemLanguageGroupsW(
  [in] LANGUAGEGROUP_ENUMPROCW lpLanguageGroupEnumProc,
  [in] DWORD                   dwFlags,
  [in] LONG_PTR                lParam
);

参数

[in] lpLanguageGroupEnumProc

指向应用程序定义的回调函数的指针。 有关详细信息,请参阅 EnumLanguageGroupsProc

[in] dwFlags

指定要枚举的语言组标识符的标志。 此参数可以具有以下值之一。

含义
LGRPID_INSTALLED
仅枚举已安装的语言组标识符。
LGRPID_SUPPORTED
枚举所有支持的语言组标识符。

[in] lParam

要传递给回调函数的应用程序定义值。 此参数可用于错误检查。 它还可用于确保回调函数中的线程安全。

返回值

如果成功,则返回 TRUE ,否则返回 FALSE 。 若要获取扩展的错误信息,应用程序可以调用 GetLastError,这会返回以下错误代码之一:

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

注解

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

注意

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

要求

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

另请参阅

EnumLanguageGroupLocales

EnumLanguageGroupsProc

IsValidLanguageGroup

国家/地区语言支持

国家/地区语言支持函数