Skip to main content

IXtfCopyFileCallback::OnStartFileCopy 方法

在開發主機上的兩個位置之間開始複製檔案時呼叫。

語法

參數

pszRootDirectory
類型:LPCWSTR
指向複製作業之根目錄路徑的指標。 pszSearchPattern
類型:LPCWSTR
指向搜尋模式的指標,此模式定義要複製之來源檔案的檔案名稱。此參數接受萬用字元,以比對符合所指定模式的字串。 pSrcFileInfo
類型:LPCXTFFILEINFO
指向 XTFFILEINFO 結構的指標,該結構包含所複製檔案的相關資訊。 pszDstFileName
類型:LPCWSTR
指向目標檔案之檔案名稱的指標。

傳回值

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

備註

IXtfFileIOClient::CopyFiles 方法會在檔案複製作業開始時呼叫此回呼函式一次。XTFFILEINFO 結構中傳回的檔案大小代表需要複製之檔案大小的總和 (以位元組為單位)。您可以使用此總和來追蹤檔案複製作業的整體進度。如果此回呼函式傳回 HRESULT 錯誤碼,檔案複製作業就會中止。

需求

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

另請參閱

IXtfCopyFileCallback 介面
XtfFileIO
Last modified on October 6, 2026