Skip to main content

IXtfFileIOClient::CopyFiles 方法

在開發主機上的兩個位置之間複製檔案,並傳回作業的相關資訊。

語法

參數

pszSearchPattern
類型:LPCWSTR
指向搜尋模式的指標,此模式定義要複製之來源檔案的檔案名稱。此參數接受萬用字元,以比對符合所指定模式的字串。 dwIncludeAttributes
類型:DWORD
要納入複製作業之檔案屬性的位元 OR 組合。如需可能的屬性清單,請參閱檔案屬性常數。 dwExcludeAttributes
類型:DWORD
要從複製作業中排除之檔案屬性的位元 OR 組合。如需可能的屬性清單,請參閱檔案屬性常數。 dwRecursionLevels
類型:DWORD
複製作業要遞迴的目錄層級數目,或指定 -1 以涵蓋目錄樹狀結構的所有層級。 pszDstFileName
類型:LPCWSTR
指向要複製到之目標檔案的檔案名稱的指標。 dwFlags
類型:DWORD
指定如何複製檔案的旗標。這是下表所列巨集的位元 OR 組合。 pCallback
類型:IXtfCopyFileCallback*
指向 IXtfCopyFileCallback 回呼的指標,當複製狀態變更時就會呼叫此回呼。

傳回值

類型:HRESULT 如果成功,則傳回 S_OK;否則傳回 HRESULT 錯誤碼。

備註

IXtfFileIOClient::CopyFiles 會啟動將一或多個檔案從 XBOX 主機上的一個位置複製到另一個位置的程序。若要追蹤檔案複製命令的進度,請使用 IXtfCopyFileCallback 的執行個體來定義回呼函式。IXtfCopyFileCallback 包含在檔案複製作業開始時、有進度時,以及最後完成後所呼叫的回呼函式。
使用萬用字元複製多個檔案時,pszDstFileName 參數會被視為目錄,所有複製的檔案都會放在該目錄中。如果該目錄不存在,則會在複製檔案之前建立它。
dwIncludeAttributes 和 dwExcludeAttributes 參數可作為篩選條件,指出要複製哪些檔案。這些參數並非用來篩選複製檔案時要複製哪些檔案屬性。

需求

標頭: xtffileio.h 程式庫: xtffileio.lib 支援的平台: Windows (適用於 XBOX 主機工具)

另請參閱

IXtfFileIOClient 介面
XtfFileIO
Last modified on October 6, 2026