Функция RtlIsValidLocaleName

Статья
06/13/2023

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

Примечание

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

Синтаксис

BOOL RtlIsValidLocaleName(
  _In_ LPCWSTR LocaleName,
  _In_ ULONG   Flags
);

Параметры

LocaleName [in]: Имя языкового стандарта для проверки. Этот параметр может указывать имя пользовательского языкового стандарта.
Флаги [в]: Флаги, указывающие, считаются ли нейтральные языковые параметры допустимыми. В настоящее время единственным определенным флагом является LOCALE_ALLOW_NEUTRAL. Значением по умолчанию является то, что они не являются.

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

Возвращает ненулевое значение в случае успешного выполнения или значение 0 в противном случае.

Эта функция похожа на IsValidLocaleName. Единственное отличие заключается в том, что если задано LOCALE_ALLOW_NEUTRAL, функция RtlIsValidLocaleName возвращает true для имени, соответствующего нейтральному языковому стандарту (например, "en"), а IsValidLocaleName возвращает значение TRUE только для определенного языкового стандарта (например, "en-US"). Нейтральные языковые параметры используются в рамках стратегии загрузки ресурсов в Windows Vista и более поздних версиях. Только небольшой класс узкоспециалированных приложений использует RtlIsValidLocaleName и устанавливает LOCALE_ALLOW_NEUTRAL, так как нейтральные языковые параметры используются очень ограниченно. Ни одна из функций, описанных в разделе Вызов имени языкового стандарта, функции не принимают нейтральные языковые параметры в качестве входных данных.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Заголовок	Ntrtl.h
Библиотека	Kernel32.lib
DLL	Kernel32.dll

См. также

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