Функция 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 |