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

  • Статья

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

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

Синтаксис

BOOL EnumSystemLocalesA(
  [in] LOCALE_ENUMPROCA lpLocaleEnumProc,
  [in] DWORD            dwFlags
);

Параметры

[in] lpLocaleEnumProc

Указатель на определяемую приложением функцию обратного вызова. Дополнительные сведения см. в разделе EnumLocalesProc.

[in] dwFlags

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

Значение Значение
LCID_INSTALLED
 Перечисление только установленных идентификаторов языкового стандарта. Это значение нельзя использовать с LCID_SUPPORTED.
LCID_SUPPORTED
 Перечисление всех поддерживаемых идентификаторов языкового стандарта. Это значение нельзя использовать с LCID_INSTALLED.
LCID_ALTERNATE_SORTS
 Перечислять только идентификаторы альтернативного языкового стандарта сортировки. Если это значение используется с LCID_INSTALLED или LCID_SUPPORTED, извлекаются установленные или поддерживаемые языковые параметры, а также идентификаторы альтернативных языковых стандартов сортировки.

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

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

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

Комментарии

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

Примечание

Заголовок winnls.h определяет EnumSystemLocales в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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

См. также

EnumLocalesProc

EnumSystemLocalesEx

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

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