verLanguageNameA 函数 (winver.h)

检索与指定的二进制 Microsoft 语言标识符关联的语言的说明字符串。

语法

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 字符。 如果说明字符串小于或等于缓冲区,则整个说明字符串位于缓冲区中。 如果说明字符串大于缓冲区,则说明字符串将被截断为缓冲区的长度。

如果发生错误,则返回值为 0。 未知的语言标识符不会产生错误。

注解

此函数适用于 16 位、32 位和 64 位文件映像。

通常,安装程序使用此函数来翻译 VerQueryValue 函数返回的语言标识符。 文本字符串可用于询问用户在发生语言冲突时如何继续操作的对话框。

注意

winver.h 标头将 VerLanguageName 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 winver.h (包括 Windows.h)
Library Version.lib
DLL Api-ms-win-core-localization-l1-2-1.dll

另请参阅

版本信息概述