Skip to main content

IXtfCopyFileCallback::OnFileCopyProgress 方法

在檔案複製進度變更時呼叫。

語法

參數

pszSrcFileName
類型:LPCWSTR
指向來源檔案之檔案名稱的指標。此參數已淘汰,其值現在是 pszDstFileName 的複本。 pszDstFileName
類型:LPCWSTR
指向目標檔案之檔案名稱的指標。 ullFileSize
類型:ULONGLONG
來源檔案的總大小 (以位元組為單位)。 ullBytesCopied
類型:ULONGLONG
目前為止已複製的檔案位元組數。

傳回值

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

備註

在檔案複製作業期間,IXtfFileIOClient::CopyFiles 方法每傳輸一個封包就會呼叫此函式。針對某個檔案初次呼叫 IXtfCopyFileCallback::OnFileCopyProgress 時,會在 ullBytesCopied 中指定 0 個位元組,並在 ullFileSize 中指定 MAX_FILE_SIZE 個位元組。此初次呼叫表示您已開始複製新檔案。接著,您可以使用後續 IXtfCopyFileCallback::OnFileCopyProgress 呼叫中指定的檔案資訊,來追蹤並顯示檔案複製作業期間的進度。如果此回呼函式傳回 HRESULT 錯誤碼,檔案複製作業就會中止。

需求

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

另請參閱

IXtfCopyFileCallback 介面
XtfFileIO
Last modified on October 6, 2026