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

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

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

 

Синтаксис

int LCIDToLocaleName(
  [in]            LCID   Locale,
  [out, optional] LPWSTR lpName,
  [in]            int    cchName,
  [in]            DWORD  dwFlags
);

Параметры

[in] Locale

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

• LOCALE_INVARIANT
• LOCALE_SYSTEM_DEFAULT
• LOCALE_USER_DEFAULT

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

• LOCALE_CUSTOM_DEFAULT
• LOCALE_CUSTOM_UI_DEFAULT
• LOCALE_CUSTOM_UNSPECIFIED

[out, optional] lpName

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

• LOCALE_NAME_INVARIANT
• LOCALE_NAME_SYSTEM_DEFAULT
• LOCALE_NAME_USER_DEFAULT

[in] cchName

Размер буфера имен языкового стандарта (в символах). Максимально возможная длина имени языкового стандарта, включая завершающий символ NULL, составляет LOCALE_NAME_MAX_LENGTH. Это рекомендуемый размер для этого параметра.

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

[in] dwFlags

До Windows 7: Защищены; всегда должен иметь значение 0.

Начиная с Windows 7: Можно задать значение LOCALE_ALLOW_NEUTRAL_NAMES , чтобы разрешить возврат нейтрального имени.

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

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

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

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

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера	Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа	Windows
Header	winnls.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll

См. также

LocaleNameToLCID

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

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