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