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

  • Статья

[IsValidLocale доступен для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Вместо этого используйте IsValidLocaleName , чтобы определить допустимость дополнительного языкового стандарта.]

Определяет, установлен или поддерживается указанный языковой стандарт в операционной системе. Дополнительные сведения см. в разделе Языковые стандарты и языки.

Синтаксис

BOOL IsValidLocale(
  [in] LCID  Locale,
  [in] DWORD dwFlags
);

Параметры

[in] Locale

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

[in] dwFlags

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

Значение Значение
LCID_INSTALLED
 Определите, поддерживается ли и установлен идентификатор языкового стандарта.
LCID_SUPPORTED
 Определите, поддерживается ли идентификатор языкового стандарта.
0x39
 Не используйте. Вместо этого используйте LCID_INSTALLED.

Windows Server 2008, Windows Vista, Windows Server 2003, Windows XP и Windows 2000: Настройка dwFlags для 0x39 является особым случаем, который может вести себя как LCID_INSTALLED для некоторых языковых стандартов в некоторых версиях Windows.

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

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

Комментарии

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

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

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

Требования

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

См. также

GetLocaleInfo

IsValidLocaleName

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

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