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

另請參閱

版本資訊概觀