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 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | winver.h (包括 Windows.h) |
| 程式庫 | Version.lib |
| Dll | Api-ms-win-core-localization-l1-2-1.dll |