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

Статья
03/08/2023

Извлекает сведения о текущей версии указанной возможности NLS для языкового стандарта, указанного идентификатором.

Примечание По соображениям взаимодействия приложение должно предпочесть функцию GetNLSVersionEx, так как корпорация Майкрософт переходит на использование имен языкового стандарта вместо идентификаторов языкового стандарта для новых языковых стандартов. Эта рекомендация особенно применима к пользовательским языковым стандартам, для которых GetNLSVersionEx получает достаточно информации, чтобы определить, изменилось ли поведение сортировки. Любое приложение, которое выполняется только в Windows Vista и более поздних версий, должно использовать GetNLSVersionEx или по крайней мере передавать структуру NLSVERSIONINFOEX при вызове GetNLSVersion для получения дополнительных данных управления версиями сортировки.

Синтаксис

BOOL GetNLSVersion(
  [in]      NLS_FUNCTION     Function,
  [in]      LCID             Locale,
  [in, out] LPNLSVERSIONINFO lpVersionInformation
);

Параметры

[in] Function

Возможность NLS для запроса. Это значение должно быть COMPARE_STRING. См. перечисление SYSNLS_FUNCTION .

[in] Locale

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

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

[in, out] lpVersionInformation

Указатель на структуру NLSVERSIONINFO . Приложение должно инициализировать член dwNLSVersionInfoSize в .sizeof(NLSVERSIONINFO)

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

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

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

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

Эта функция позволяет приложению, такому как Active Directory, определить, влияет ли изменение NLS на идентификатор языкового стандарта, используемый для конкретной таблицы индексов. В противном случае нет необходимости переиндексировать таблицу. Дополнительные сведения см. в разделе Обработка сортировки в приложениях.

Требования


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