Функция DownlevelLocaleNameToLCID

Статья
12/21/2023

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

Примечание.

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

Синтаксис

LCID DownlevelLocaleNameToLCID(
  _In_ LPWSTR lpName,
  _In_ DWORD  dwFlags
);

Параметры

lpName [in]: Указатель на строку, завершающуюся значением NULL, представляющую имя языкового стандарта.
dwFlags [in]: Флаги, указывающие тип имени. Значение по умолчанию — DOWNLEVEL_LOCALE_NAME.

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

Возвращает идентификатор языкового стандарта, соответствующий имени языкового стандарта в случае успешного выполнения.

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

ERROR_INVALID_FLAGS. Значения, предоставленные для флагов, недопустимы.
ERROR_INVALID_PARAMETER. Любые значения параметров были недопустимыми.

Замечания

Примечание.

Эта функция не поддерживает нейтральные языковые параметры. Эквивалентная функция LocaleNameToLCID поддерживает пользовательские языковые параметры, но только для Windows Vista и более поздних версий.

Необходимый файл заголовка и DLL являются частью скачивания "API сопоставления данных нижнего уровня Microsoft NLS", который больше недоступен в Центре загрузки Майкрософт. Используйте API глобализации ICU в обновление Windows 10 за май 2019 г. и более поздних версиях.

Requirements

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Распространяемые компоненты	API сопоставления данных в Microsoft NLS Downlevel вWindows XP с пакетом обновления 2 (SP2) и laterorWindows Vista
Верхний колонтитул	Nlsdl.h
DLL-библиотеки	NlsMap.dll

См. также

Поддержка национального языка
Функции поддержки национальных языков
Сопоставление данных языкового стандарта
LocaleNameToLCID

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