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

Статья
11/20/2024

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

Примечание Для пользовательских языковых стандартов приложение должно вызывать 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 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winnls.h (включая Windows.h)
библиотеки	Kernel32.lib
DLL	Kernel32.dll

См. также

EnumLanguageGroupLocales

EnumLanguageGroupsProc

IsValidLanguageGroup

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

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

Поделиться через