VerLanguageNameA 函数 (winver.h)

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

语法

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

参数

[in] wLang

类型:DWORD

二进制语言标识符。 有关语言标识符的完整列表,请参阅 语言标识符

例如,与语言标识符关联的说明字符串0x040A为“西班牙语(传统排序)”。 如果标识符未知,szLang 参数指向默认字符串(“语言中性”)。

[out] szLang

类型:LPTSTR

wLang 参数指定的语言。

[in] cchLang

类型:DWORD

szLang指向的缓冲区的大小(以字符为单位)。

返回值

类型:DWORD

返回值是缓冲区中返回的字符串的大小(以字符为单位)。 此值不包括终止 null 字符。 如果说明字符串小于或等于缓冲区,则整个说明字符串位于缓冲区中。 如果说明字符串大于缓冲区,则说明字符串将被截断为缓冲区的长度。

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

言论

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

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

注意

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

要求

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

另请参阅

版本信息概述