Функция EnumSystemLanguageGroupsA (winnls.h)

  • Статья

Перечисляет языковые группы, установленные или поддерживаемые операционной системой.

Примечание Для пользовательских языковых стандартов приложение должно вызывать EnumSystemLocalesEx вместо EnumSystemLanguageGroups.

 

Синтаксис

BOOL EnumSystemLanguageGroupsA(
  [in] LANGUAGEGROUP_ENUMPROCA 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 в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header winnls.h (включая Windows.h)
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

EnumLanguageGroupLocales

EnumLanguageGroupsProc

IsValidLanguageGroup

Поддержка национальных языков

Функции поддержки национальных языков