Функция VerLanguageNameA (winver.h)

  • Статья

Извлекает строку описания для языка, связанного с указанным двоичным идентификатором языка Майкрософт.

Синтаксис

DWORD VerLanguageNameA(
  [in]  DWORD wLang,
  [out] LPSTR szLang,
  [in]  DWORD cchLang
);

Параметры

[in] wLang

Тип: DWORD

Идентификатор двоичного языка. Полный список идентификаторов языков см. в разделе Идентификаторы языка.

Например, строка описания, связанная с идентификатором языка 0x040A, — "Испанский (традиционная сортировка)". Если идентификатор неизвестен, параметр szLang указывает на строку по умолчанию ("Language Neutral").

[out] szLang

Тип: LPTSTR

Язык, заданный параметром wLang .

[in] cchLang

Тип: DWORD

Размер (в символах) буфера, на который указывает szLang.

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

Тип: DWORD

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

При возникновении ошибки возвращаемое значение равно нулю. Неизвестные идентификаторы языка не создают ошибок.

Комментарии

Эта функция работает с 16-, 32- и 64-разрядными образами файлов.

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

Примечание

Заголовок winver.h определяет VerLanguageName в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header winver.h (включая Windows.h)
Библиотека Version.lib
DLL Api-ms-win-core-localization-l1-2-1.dll

См. также раздел

Обзор сведений о версии