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