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

Статья
11/20/2024

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

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

Синтаксис

BOOL EnumSystemLocalesW(
  [in] LOCALE_ENUMPROCW 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 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winnls.h (включая Windows.h)
библиотеки	Kernel32.lib
DLL	Kernel32.dll

См. также

EnumLocalesProc

EnumSystemLocalesEx

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

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

Поделиться через