GetFileVersionInfoW 函式 （winver.h）
擷取指定檔案的版本資訊。
語法
BOOL GetFileVersionInfoW(
[in] LPCWSTR lptstrFilename,
DWORD dwHandle,
[in] DWORD dwLen,
[out] LPVOID lpData
);
參數
[in] lptstrFilename
類型：LPCTSTR
檔名。 如果未指定完整路徑，則函式會使用由 LoadLibrary 函式指定的搜尋順序。
dwHandle
類型：DWORD
這個參數會被忽略。
[in] dwLen
類型：DWORD
lpData 參數所指向之緩衝區的大小，以位元組為單位。
先呼叫 GetFileVersionInfoSize 函式，以判斷檔案版本資訊的大小，以位元組為單位。 dwLen 成員應等於或大於該值。
如果 lpData 所指向的緩衝區不夠大，函式會將檔案的版本資訊截斷為緩衝區的大小。
[out] lpData
類型：LPVOID
接收檔案版本信息的緩衝區指標。
您可以在後續呼叫 VerQueryValue 函式中使用此值，從緩衝區擷取數據。
傳回值
類型：BOOL
如果函式成功，則傳回值為非零值。
如果函式失敗，傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
言論
檔案版本資訊具有固定和非固定部分。 固定元件包含版本號碼等資訊。 非固定部分包含字串之類的專案。 過去 GetFileVersionInfo 從二進位檔 （exe/dll） 取得版本資訊。 目前，它會從語言中性檔案 （exe/dll） 和 mui 檔案的非固定部分查詢固定版本，並將它們合併並傳回給使用者。 如果指定的二進位檔沒有 mui 檔案，則行為會和舊版一樣。
呼叫 getFileVersionInfoSize 函式，再呼叫 GetFileVersionInfo 函式。 若要從檔案版本信息緩衝區擷取資訊，請使用 VerQueryValue 函式。
注意
winver.h 標頭會將 GetFileVersionInfo 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| 標頭 | winver.h （包括 Windows.h） |
| 連結庫 | Version.lib |
| DLL | Api-ms-win-core-version-l1-1-0.dll |
另請參閱
概念
參考