共用方式為


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

另請參閱

版本資訊概觀