VerLanguageNameW 函式 (winver.h)
擷取與指定二進位 Microsoft 語言標識符相關聯之語言的描述字串。
語法
DWORD VerLanguageNameW(
[in] DWORD wLang,
[out] LPWSTR 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 |