SetupQueueCopyA 函式 （setupapi.h）
[此函式可用於需求一節所指出的作業系統。 後續版本可能會變更或無法使用。 安裝程式API 不應該再用於安裝應用程式。 請改用 Windows Installer 來開發應用程式安裝程式。 SetupAPI 會繼續用於安裝設備驅動器。]
SetupQueueCopy 函式會將單一檔案複製作業新增至安裝程式檔案佇列。
語法
WINSETUPAPI BOOL SetupQueueCopyA(
[in] HSPFILEQ QueueHandle,
[in] PCSTR SourceRootPath,
[in] PCSTR SourcePath,
[in] PCSTR SourceFilename,
[in] PCSTR SourceDescription,
[in] PCSTR SourceTagfile,
[in] PCSTR TargetDirectory,
[in] PCSTR TargetFilename,
[in] DWORD CopyStyle
);
參數
[in] QueueHandle
安裝程式檔案佇列的句柄，如 setupOpenFileQueue
[in] SourceRootPath
null 的指標終止字串，指定此複本來源的根目錄，例如 A：。
[in] SourcePath
[in] SourceFilename
null 的指標終止字串，指定要複製之檔案的檔名部分。
[in] SourceDescription
null終止字串的指標，指定磁碟提示期間所要使用的來源媒體描述。 此參數可以是 NULL
[in] SourceTagfile
[in] TargetDirectory
null終止字串的指標，指定要複製檔案的目錄。
[in] TargetFilename
指定目標檔名稱之 null終止字串的指標。 此參數可能會 NULL。 如果未指定，目標檔案的名稱會與原始程序檔相同。
[in] CopyStyle
指定檔案複製作業的行為。 此參數可能是下列值的組合。
SP_COPY_DELETESOURCE
成功複製時，請刪除來源檔案。 如果刪除失敗，則不會通知呼叫端。
SP_COPY_REPLACEONLY
只有在這樣做會覆寫目的地路徑上的檔案時，才複製檔案。 呼叫端未收到通知。
SP_COPY_NEWER_OR相同
檢查所複製的每個檔案，以查看其版本資源是否表示其版本是否與目標上的現有複本相同或不是更新版本。
在版本檢查期間所使用的檔案版本資訊，是在 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 目錄不存在，檔案複製將會失敗。
注意
setupapi.h 標頭會將 SetupQueueCopy 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| 標頭 | setupapi.h |
| 連結庫 | Setupapi.lib |
| DLL | Setupapi.dll |