Функция DownlevelGetParentLocaleName

Извлекает имя языкового стандарта для родительского стандарта предоставленного языкового стандарта.

Примечание.

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

 

Синтаксис

int DownlevelGetParentLocaleName(
  _In_  LCID   Locale,
  _Out_ LPWSTR lpName,
  _In_  int    cchName
);

Параметры

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

Идентификатор языкового стандарта . Макрос MAKELCID можно использовать для создания идентификатора языкового стандарта или использования одного из следующих предопределенных значений.

• LOCALE_INVARIANT
• LOCALE_SYSTEM_DEFAULT
• LOCALE_USER_DEFAULT

Windows Vista и более поздних версий: также поддерживаются следующие пользовательские идентификаторы языкового стандарта.

• LOCALE_CUSTOM_DEFAULT
• LOCALE_CUSTOM_UI_DEFAULT
• LOCALE_CUSTOM_UNSPECIFIED

lpName [out]

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

• LOCALE_NAME_INVARIANT
• LOCALE_NAME_SYSTEM_DEFAULT
• LOCALE_NAME_USER_DEFAULT

cchName [in]

Размер буфера, указанного lpName, в точках кода UTF-16. Значение 0 для этого параметра приводит к тому, что функция игнорирует буфер lpName и возвращает размер буфера в символах (включаемых null символов), необходимых для хранения родительского имени языкового стандарта.

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

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

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

• ERROR_INSUFFICIENT_BUFFER. Предоставленный размер буфера был недостаточно велик или неправильно задан значение NULL.
• 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) и более поздних версий
Верхний колонтитул	Nlsdl.h
DLL-библиотеки	NlsMap.dll

См. также

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

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

Сопоставление данных языкового стандарта

GetLocaleInfo