共用方式為

SetupQueueDefaultCopyA 函式 （setupapi.h）

  • 發行項

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

SetupQueueDefaultCopy 函式會使用 INF 檔案中指定的預設來源媒體和目的地，將單一檔案新增至安裝程式檔案佇列以進行複製。

語法

WINSETUPAPI BOOL SetupQueueDefaultCopyA(
  [in] HSPFILEQ QueueHandle,
  [in] HINF     InfHandle,
  [in] PCSTR    SourceRootPath,
  [in] PCSTR    SourceFilename,
  [in] PCSTR    TargetFilename,
  [in] DWORD    CopyStyle
);

參數

[in] QueueHandle

安裝程式檔案佇列的句柄，如 setupOpenFileQueue所傳回。

[in] InfHandle

處理包含 SourceDisksFiles 和 SourceDisksNames 區段的開啟 INF 檔案。 如果用戶的系統存在平臺特定區段（例如，SourceDisksNames.x86 和 SourceDisksFiles.x86），則會使用平臺特定區段。

[in] SourceRootPath

Null 終止字串的指標，指定此複本之來源的根目錄，例如 A：。

[in] SourceFilename

Null 終止字串的指標，指定要複製之檔案的檔名。

[in] TargetFilename

指定目標檔案檔名之 Null 終止字串的指標。

[in] CopyStyle

旗標，控制檔案複製作業的行為。 這些旗標可能是下列值的組合。

SP_COPY_DELETESOURCE

成功複製時，請刪除來源檔案。 如果刪除失敗，則不會通知呼叫端。

SP_COPY_REPLACEONLY

只有在這樣做會覆寫目的地路徑上的檔案時，才複製檔案。

SP_COPY_NEWER_OR_SAME

檢查要複製的每個檔案，以查看其版本資源是否表示其版本是否等於或不是目標上現有的複本。

在版本檢查期間所使用的檔案版本資訊，是在 dwFileVersionMS 和 dwFileVersionLSVS_FIXEDFILEINFO 結構的成員中所指定，如版本函式所填入。 如果其中一個檔案沒有版本資源，或它們具有相同的版本資訊，則來源檔案會被視為較新。

如果原始程式檔在版本或更新版本中不相等，且已指定 CopyMsgHandler，呼叫端會收到通知，而且可能會取消複本。 如果未指定 CopyMsgHandler，則不會複製檔案。

SP_COPY_NEWER_ONLY

檢查要複製的每個檔案，以查看其版本資源是否表示它不是比目標上現有的複本還新。 如果來源檔案較新，但不等於現有目標的版本，則會複製該檔案。

SP_COPY_NOOVERWRITE

檢查目標檔案是否存在，如果是的話，請通知可能否決該複本的呼叫端。 如果未指定 copyMsgHandler ，則不會覆寫檔案。

SP_COPY_NODECOMP

請勿解壓縮檔案。 設定此旗標時，目標檔案不會提供來源名稱的未壓縮形式（如果適當的話）。 例如，將 f：\x86\cmd.ex_複製到 \install\temp 會導致目標檔案為 \install\temp\cmd.ex_。 如果未指定SP_COPY_NODECOMP旗標，則會解壓縮檔案，並將目標稱為 \install\temp\cmd.exe。 DestinationName的檔名部分，如果指定，則會移除並以來源檔案的檔名取代。 指定SP_COPY_NODECOMP時，無法檢查任何語言或版本資訊。

SP_COPY_LANGUAGEAWARE

檢查所複製的每個檔案，以查看其語言是否與目標上任何現有檔案的語言不同。 若是如此，並指定 CopyMsgHandler，呼叫端會收到通知，而且可能會取消複本。 如果未指定 CopyMsgHandler，則不會複製檔案。

SP_COPY_SOURCE_ABSOLUTE

SourceFile 是完整的來源路徑。 請勿在 INF 檔案的 SourceDisksNames 區段中查閱。

SP_COPY_SOURCEPATH_ABSOLUTE

SourcePathRoot 是來源檔案的完整路徑部分。 針對檔案所在的來源媒體，忽略 INF 檔案 SourceDisksNames 區段中指定的相對來源。 如果指定SP_COPY_SOURCE_ABSOLUTE，則會忽略此旗標。

SP_COPY_FORCE_IN_USE

如果目標存在，則行為就好像正在使用中，並在下一次系統重新啟動時將檔案排入佇列。

SP_COPY_IN_USE_NEEDS_REBOOT

如果檔案在複製作業期間正在使用中，請提醒使用者系統必須重新啟動。

SP_COPY_NOSKIP

請勿提供使用者略過檔案的選項。

SP_COPY_FORCE_NOOVERWRITE

檢查目標檔案是否存在，如果存在，則不會覆寫檔案。 呼叫端未收到通知。

SP_COPY_FORCE_NEWER

檢查每個正在複製的檔案，以查看其版本資源（或非映像檔案的時間戳）是否表示它不比目標上的現有複本還新。 如果複製的檔案不是較新檔案，則不會複製檔案。 呼叫端未收到通知。

SP_COPY_WARNIFSKIP

如果用戶嘗試略過檔案，請警告他們略過檔案可能會影響安裝。 （用於系統關鍵檔案。）

傳回值

如果函式成功，則傳回值是非零值。

如果函式失敗，傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

言論

如果 UNC 目錄指定為檔案複製作業的目標目錄，您必須先確定它存在，才能認可佇列。 安裝程式函式不會檢查 是否存在，而且不會建立 UNC 目錄。 如果目標 UNC 目錄不存在，檔案複製將會失敗。

此函式所使用的預設目的地是由 INF 檔案 DestinationDirs 區段中的 DefaultDestDir 索引鍵所指定。

此函式需要 Windows INF 檔案。 某些較舊的 INF 檔案格式可能不受支援。

注意

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

要求

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

另請參閱

函式

概觀

SetupQueueCopy

SetupQueueCopySection