共用方式為

SetupDecompressOrCopyFileA 函式 （setupapi.h）

  • 發行項

[此函式可用於需求一節所指出的作業系統。 後續版本可能會變更或無法使用。 安裝程式API 不應該再用於安裝應用程式。 請改用 Windows Installer 來開發應用程式安裝程式。 SetupAPI 會繼續用於安裝設備驅動器。]

SetupDecompressOrCopyFile 函式會複製檔案，並視需要解壓縮。

如果複製檔案，此函式的呼叫端必須具有寫入目標目錄的許可權。

語法

WINSETUPAPI DWORD SetupDecompressOrCopyFileA(
  [in] PCSTR SourceFileName,
  [in] PCSTR TargetFileName,
  [in] PUINT CompressionType
);

參數

[in] SourceFileName

要複製之檔案的檔名。 您應該使用 null-terminated 字串。 此參數可以是 NULL。 如果未指定 CompressionType，而且 SetupDecompressOrCopyFile 函式找不到 sourceFileName中指定的檔案，則函式會搜尋最多兩個替代 “compressed-form” 名稱的檔案。 例如，如果檔案 F:\x86\cmd.exe 且找不到檔案，則函式會搜尋 F：\x86\cmd.ex_，如果找不到，則會搜尋 F：\x86\cmd.ex$ 。 如果指定 CompressionType，則不會對檔名執行任何其他處理;檔案必須完全與指定的一樣存在，否則函式會失敗。

[in] TargetFileName

解壓縮或複製來源檔案所建立之目標檔案的確切名稱。 您應該使用 null-terminated 字串。

[in] CompressionType

來源檔案上使用之壓縮類型的選擇性指標。 您可以呼叫 SetupGetFileCompressionInfo來判斷壓縮類型。 如果此值是FILE_COMPRESSION_NONE，則不論來源上使用的任何壓縮為何，檔案都會複製（未解壓縮）。 如果未指定 CompressionType，此例程會自動決定壓縮類型。

傳回值

SetupDecompressOrCopyFile 函式會傳回指出作業結果的 系統錯誤碼。

若要取得擴充的錯誤資訊，請呼叫 GetLastError。

言論

注意

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

要求

要求 價值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 setupapi.h
連結庫 Setupapi.lib
DLL Setupapi.dll

另請參閱

函式

概觀

SetupGetFileCompressionInfo