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

  • Статья

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

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

 

Синтаксис

int GetUserDefaultLocaleName(
  [out] LPWSTR lpLocaleName,
  [in]  int    cchLocaleName
);

Параметры

[out] lpLocaleName

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

[in] cchLocaleName

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

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

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

Примечание В однопользовательских системах возвращаемое значение совпадает с значением GetSystemDefaultLocaleName.

 

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

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

Комментарии

Эта функция может извлекать данные из пользовательских языковых стандартов. Данные не обязательно будут одинаковыми с компьютера на компьютер или между запусками приложения. Если приложение должно сохранять или передавать данные, см. статью Использование данных сохраняемого языкового стандарта.

Требования

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

См. также

GetLocaleInfoEx

GetSystemDefaultLocaleName

GetUserDefaultLCID

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

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