GetFileVersionInfoExW 函式 (winver.h)
擷取指定檔案的版本資訊。
語法
BOOL GetFileVersionInfoExW(
[in] DWORD dwFlags,
[in] LPCWSTR lpwstrFilename,
DWORD dwHandle,
[in] DWORD dwLen,
[out] LPVOID lpData
);
參數
[in] dwFlags
類型: DWORD
如果從中擷取版本資源的任何) ,則控制 MUI DLL (。 此旗標的值必須符合傳遞至對應 GetFileVersionInfoSizeEx 呼叫的旗標,此呼叫用來判斷 在 dwLen 參數中傳遞的緩衝區大小。 下列旗標的零個或多個。
[in] lpwstrFilename
類型: LPCTSTR
檔案的名稱。 如果未指定完整路徑,函式會使用 LoadLibrary 函式所指定的搜尋順序。
dwHandle
類型: DWORD
這個參數已忽略。
[in] dwLen
類型: DWORD
lpData 參數所指向之緩衝區的大小,以位元組為單位。
請先呼叫 GetFileVersionInfoSizeEx 函式,以判斷檔案版本資訊的大小,以位元組為單位。 dwLen 參數應等於或大於該值。
如果 lpData 所指向的緩衝區不夠大,函式會將檔案的版本資訊截斷為緩衝區的大小。
[out] lpData
類型: LPVOID
當此函式傳回時,包含包含檔案版本信息的緩衝區指標。
您可以在 後續呼叫 VerQueryValue 函式時使用此值,從緩衝區擷取數據。
傳回值
類型: BOOL
如果函式成功,則傳回非零的值。
如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。
備註
呼叫 GetFileVersionInfoSizeEx 函式之前,請先呼叫 GetFileVersionInfoEx 函式。 若要從檔案版本信息緩衝區擷取資訊,請使用 VerQueryValue 函式。
注意
winver.h 標頭會將 GetFileVersionInfoEx 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | winver.h (包括 Windows.h) |
程式庫 | Version.lib |
Dll | Api-ms-win-core-version-l1-1-0.dll |
另請參閱
概念
參考