共用方式為

VerInstallFileW 函式 （winver.h）

  • 發行項

根據從 VerFindFile 函式傳回的信息，安裝指定的檔案。 VerInstallFile 視需要將檔案解壓縮，並指派唯一的檔名，並檢查是否有錯誤，例如過期的檔案。

語法

DWORD VerInstallFileW(
  [in]      DWORD   uFlags,
  [in]      LPCWSTR szSrcFileName,
  [in]      LPCWSTR szDestFileName,
  [in]      LPCWSTR szSrcDir,
  [in]      LPCWSTR szDestDir,
  [in]      LPCWSTR szCurDir,
  [out]     LPWSTR  szTmpFile,
  [in, out] PUINT   puTmpFileLen
);

參數

[in] uFlags

類型：DWORD

此參數可以是下列其中一個值。 所有其他位都會保留。

價值 意義
VIFF_FORCEINSTALL
0x0001
 安裝檔案，不論版本號碼不相符。 函式只會檢查安裝期間的實體錯誤。
VIFF_DONTDELETEOLD
0x0002
 如果先前安裝的檔案不在目的地目錄中，則安裝檔案而不刪除先前安裝的檔案。

[in] szSrcFileName

類型：LPCTSTR

要安裝的檔名。 這是 szSrcDir 參數所指向目錄中的檔名;檔名只能包含檔名和擴展名，而不是路徑。

[in] szDestFileName

類型：LPCTSTR

VerInstallFile 名稱會在安裝時提供新檔案。 此檔名可能與 szSrcFileName 目錄中的檔名不同。 新的名稱應該只包含檔名和擴展名，而不是路徑。

[in] szSrcDir

類型：LPCTSTR

可找到檔案的目錄名稱。

[in] szDestDir

類型：LPCTSTR

應該安裝檔案的目錄名稱。 VerFindFile 會在其 szDestDir 參數中傳回此值。

[in] szCurDir

類型：LPCTSTR

可以找到此檔案之預先存在版本的目錄名稱。 VerFindFile 會在其 szCurDir 參數中傳回此值。

[out] szTmpFile

類型：LPTSTR

原始程式檔的暫存副本名稱。 緩衝區長度至少應為 _MAX_PATH 個字元，雖然這不是必要專案，而且在輸入上應該是空的。

[in, out] puTmpFileLen

類型：PUINT

szTmpFile 緩衝區的長度。 這個指標不得 NULL。

當函式傳回時，lpuTmpFileLen 會接收 szTmpFile中所傳回數據的大小，包括終止的 Null 字元。 如果緩衝區太小而無法包含所有數據，lpuTmpFileLen 將是保存數據所需的緩衝區大小。

傳回值

類型：DWORD

傳回值是表示例外狀況的位掩碼。 它可以是下列其中一或多個值。 所有其他值都會保留。

傳回碼/值 描述
VIF_ACCESSVIOLATION
0x00000200L
 讀取、建立、刪除或重新命名作業因為存取違規而失敗。
VIF_BUFFTOOSMALL
0x00040000L
 szTmpFile 緩衝區太小，無法包含暫存原始程式檔的名稱。 當函式傳回時，lpuTmpFileLen 包含保存檔名所需的緩衝區大小。
VIF_CANNOTCREATE
0x00000800L
 函式無法建立臨時檔。 特定錯誤可能由另一個旗標描述。
VIF_CANNOTDELETE
0x00001000L
 函式無法刪除目的地檔案，或無法刪除位於另一個目錄中的現有檔案版本。 如果設定了 VIF_TEMPFILE 位，安裝就會失敗，而且目的地檔案可能無法刪除。
VIF_CANNOTDELETECUR
0x00004000L
 無法刪除現有的檔案版本，且未指定 VIFF_DONTDELETEOLD。
VIF_CANNOTLOADCABINET
0x00100000L
 函式無法載入封包檔案。
VIF_CANNOTLOADLZ32
0x00080000L
 函式無法載入壓縮檔案。
VIF_CANNOTREADDST
0x00020000L
 函式無法讀取目的地檔案（現有） 檔案。 這可防止函式檢查檔案的屬性。
VIF_CANNOTREADSRC
0x00010000L
 函式無法讀取來源檔案。 這可能表示路徑未正確指定。
VIF_CANNOTRENAME
0x00002000L
 函式無法重新命名暫存盤，但已刪除目的地檔案。
VIF_DIFFCODEPG
0x00000010L
 新檔案需要目前執行之系統版本無法顯示的代碼頁。 呼叫已設定 VIFF_FORCEINSTALL 旗標的 VerInstallFile ，即可覆寫此錯誤。
VIF_DIFFLANG
0x00000008L
 新的和預先存在的檔案有不同的語言或代碼頁值。 呼叫 VerInstallFile 並設定 VIFF_FORCEINSTALL 旗標，即可覆寫此錯誤。
VIF_DIFFTYPE
0x000000020L
 新檔案具有與預先存在檔案不同的類型、子類型或操作系統。 呼叫 VerInstallFile 並設定 VIFF_FORCEINSTALL 旗標，即可覆寫此錯誤。
VIF_FILEINUSE
0x00000080L
 系統正在使用預先存在的檔案，因此無法刪除。
VIF_MISMATCH
0x000000002L
 新的和預先存在的檔案在一或多個屬性中不同。 呼叫 VerInstallFile 並設定 VIFF_FORCEINSTALL 旗標，即可覆寫此錯誤。
VIF_OUTOFMEMORY
0x00008000L
 由於記憶體不足，函式無法完成要求的作業。 一般而言，這表示應用程式記憶體不足，嘗試擴充壓縮檔案。
VIF_OUTOFSPACE
0x00000100L
 由於目的地磁碟驅動器的磁碟空間不足，函式無法建立暫存盤。
VIF_SHARINGVIOLATION
0x00000400L
 讀取、建立、刪除或重新命名作業因為共用違規而失敗。
VIF_SRCOLD
0x000000004L
 要安裝的檔案早於預先存在的檔案。 呼叫 VerInstallFile 並設定 VIFF_FORCEINSTALL 旗標，即可覆寫此錯誤。
VIF_TEMPFILE
0x000000001L
 新檔案的暫存復本位於目的地目錄中。 失敗的原因反映在其他旗標中。
VIF_WRITEPROT
0x00000040L
 預先存在的檔案受到寫入保護。 呼叫 VerInstallFile 並設定 VIFF_FORCEINSTALL 旗標，即可覆寫此錯誤。

言論

此函式適用於16位、32位和64位檔案映像。

VerInstallFile 將檔案從來源目錄複製到目的地目錄。 如果 szCurDir 表示系統上有舊版的檔案，VerInstallFile 會比較檔案的版本戳記資訊。 如果先前安裝的檔案版本比新版本還新，或檔案的屬性明顯不同，例如，如果是不同語言，則 VerInstallFile 傳回一或多個可復原的錯誤碼。

VerInstallFile 會將暫存盤留在目的地目錄中。 應用程式可以覆寫錯誤或刪除暫存盤。 如果應用程式覆寫錯誤，VerInstallFile 會刪除先前安裝的版本，並以原始檔名重新命名暫存盤。

注意

winver.h 標頭會根據 UNICODE 預處理器常數的定義，將 VerInstallFile 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 winver.h （包括 Windows.h）
連結庫 Version.lib
DLL Api-ms-win-core-version-l1-1-0.dll

另請參閱

概念

參考

VerFindFile

版本資訊