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

Требования

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

См. также

EnumLanguageGroupLocales

EnumLanguageGroupsProc

IsValidLanguageGroup

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

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