Функция DownlevelLCIDToLocaleName

Статья
12/21/2023

Преобразует идентификатор языкового стандарта в имя языкового стандарта.

Примечание.

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

Синтаксис

int DownlevelLCIDToLocaleName(
  _In_  LCID   Locale,
  _Out_ LPWSTR lpName,
  _In_  int    cchName,
  _In_  DWORD  dwFlags
);

Параметры

Языковой стандарт [in]

Код языкового стандарта для перевода. Макрос MAKELCID можно использовать для создания идентификатора языкового стандарта. Эта функция не поддерживает нейтральные языковые стандарта или указанные ниже значения идентификатора языкового стандарта.

lpName [out]

Указатель на буфер, в котором эта функция получает имя языкового стандарта. Функция получает значение NULL , если для cchName задано значение 0.

cchName [in]

Размер в точках кода UTF-16 буфера имени языкового стандарта. Приложение задает этому параметру значение 0, чтобы вернуть требуемый размер буфера имени языкового стандарта.

dwFlags [in]

Флаги, указывающие тип имени для извлечения. Значение по умолчанию — DOWNLEVEL_LOCALE_NAME.

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

Возвращает количество точек кода UTF-16 в имени языкового стандарта, в том числе завершающегося символа NULL при успешном выполнении. Если функция завершается успешно и значение cchName равно 0, возвращаемое значение является обязательным размером в символах (включая пустые символы), для буфера имени языкового стандарта.

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

ERROR_INSUFFICIENT_BUFFER. Предоставленный размер буфера был недостаточно велик или неправильно задан значение NULL.
ERROR_INVALID_FLAGS. Недопустимое значение dwFlags .
ERROR_INVALID_PARAMETER. Любые значения параметров были недопустимыми.

Замечания

Примечание.

Эта функция не поддерживает пользовательские языковые параметры.

Необходимый файл заголовка и 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

См. также

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

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