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

Требования


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