Функция 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 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winver.h (включая Windows.h)
библиотеки	Version.lib
DLL	Api-ms-win-core-localization-l1-2-1.dll

См. также

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