Функция EnumSystemLanguageGroupsA (winnls.h)
Перечисляет языковые группы, установленные или поддерживаемые операционной системой.
Синтаксис
BOOL EnumSystemLanguageGroupsA(
[in] LANGUAGEGROUP_ENUMPROCA lpLanguageGroupEnumProc,
[in] DWORD dwFlags,
[in] LONG_PTR lParam
);
Параметры
[in] lpLanguageGroupEnumProc
Указатель на определяемую приложением функцию обратного вызова. Дополнительные сведения см. в разделе EnumLanguageGroupsProc.
[in] dwFlags
Флаги, указывающие идентификаторы языковой группы для перечисления. Этот параметр может иметь одно из следующих значений.
Значение | Значение |
---|---|
|
Перечисление только установленных идентификаторов языковой группы. |
|
Перечисление всех поддерживаемых идентификаторов языковых групп. |
[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 |