Функция DownlevelLocaleNameToLCID

  • Статья

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

Примечание.

Эта функция используется только приложениями, работающими в операционных системах до 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