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

Статья
08/27/2023

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

Примечание Приложение должно вызывать эту функцию в предпочтительном варианте EnumSystemLocales , если оно предназначено для работы только в Windows Vista и более поздних версиях.

Синтаксис

BOOL EnumSystemLocalesEx(
  [in]           LOCALE_ENUMPROCEX lpLocaleEnumProcEx,
  [in]           DWORD             dwFlags,
  [in]           LPARAM            lParam,
  [in, optional] LPVOID            lpReserved
);

Параметры

[in] lpLocaleEnumProcEx

Указатель на функцию обратного вызова, определяемую приложением. Функция EnumSystemLocalesEx перечисляет языковые стандарты, выполняя повторные вызовы этой функции обратного вызова. Дополнительные сведения см. в разделе EnumLocalesProcEx.

[in] dwFlags

Флаги, определяющие языковые стандарты для перечисления. Флаги можно использовать по отдельности или комбинировать с помощью двоичного ИЛИ. Если приложение указывает 0 для этого параметра, функция ведет себя так же, как и для LOCALE_ALL.

[in] lParam

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

[in, optional] lpReserved

Защищены; значение должно иметь значение NULL.

Возвращаемое значение

Возвращает ненулевое значение в случае успешного выполнения или 0 в противном случае. Чтобы получить расширенные сведения об ошибке, приложение может вызвать Метод GetLastError, который может возвращать один из следующих кодов ошибок:

ERROR_BADDB. Функции не удалось получить доступ к данным. Обычно такая ситуация не должна возникать и обычно указывает на неправильная установка, проблемы с диском или т. е.
ERROR_INVALID_FLAGS. Значения, указанные для флагов, были недопустимыми.
ERROR_INVALID_PARAMETER. Любое из значений параметров было недопустимым.

Эта функция перечисляет языковые стандарты, передавая имена языкового стандарта по одному за раз в определяемую приложением функцию обратного вызова, определяемую lpLocaleEnumProcEx. Перечисление продолжается до тех пор, пока все установленные или поддерживаемые имена не будут переданы в функцию обратного вызова или функция обратного вызова не вернет значение FALSE.

Параметры параметра dwFlags отличаются от вариантов для EnumSystemLocales, которые должны различать установленные и поддерживаемые языковые стандарты.

Если dwFlags указывает LOCALE_ALTERNATE_SORTS, функция обратного вызова вызывается для каждого языкового стандарта, представляющего альтернативный порядок сортировки. Например, испанский (Испания) по умолчанию использует международный порядок сортировки, но для альтернативной сортировки доступен традиционный порядок сортировки. Немецкий (Германия) по умолчанию имеет порядок сортировки по словарю, но доступен альтернативный порядок сортировки телефонной книги.

Примеры

Пример использования этой функции можно найти в разделе Пример API на основе имен NLS.

Требования

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