> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IXtfCopyFileCallback::OnFileCopyProgress 方法

> IXtfCopyFileCallback::OnFileCopyProgress 方法

# IXtfCopyFileCallback::OnFileCopyProgress 方法

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

<a id="syntaxSection" />

## 語法

```cpp theme={null}
public:
HRESULT OnFileCopyProgress(
         LPCWSTR pszSrcFileName,
         LPCWSTR pszDstFileName,
         ULONGLONG ullFileSize,
         ULONGLONG ullBytesCopied
)  
```

<a id="parametersSection" />

### 參數

*pszSrcFileName*\
類型：LPCWSTR

指向來源檔案之檔案名稱的指標。此參數已淘汰，其值現在是 pszDstFileName 的複本。

*pszDstFileName*\
類型：LPCWSTR

指向目標檔案之檔案名稱的指標。

*ullFileSize*\
類型：ULONGLONG

來源檔案的總大小 (以位元組為單位)。

*ullBytesCopied*\
類型：ULONGLONG

目前為止已複製的檔案位元組數。

<a id="retvalSection" />

### 傳回值

類型：HRESULT

如果成功，則傳回 `S_OK`；否則傳回 HRESULT 錯誤碼。

<a id="remarksSection" />

## 備註

在檔案複製作業期間，[IXtfFileIOClient::CopyFiles](/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/copyfiles-ixtffileioclient-xtffileio-xbox-microsoft-m) 方法每傳輸一個封包就會呼叫此函式。針對某個檔案初次呼叫 **IXtfCopyFileCallback::OnFileCopyProgress** 時，會在 `ullBytesCopied` 中指定 0 個位元組，並在 `ullFileSize` 中指定 MAX\_FILE\_SIZE 個位元組。此初次呼叫表示您已開始複製新檔案。接著，您可以使用後續 **IXtfCopyFileCallback::OnFileCopyProgress** 呼叫中指定的檔案資訊，來追蹤並顯示檔案複製作業期間的進度。如果此回呼函式傳回 HRESULT 錯誤碼，檔案複製作業就會中止。

<a id="requirementsSection" />

## 需求

**標頭：** xtffileio.h

**程式庫：** xtffileio.lib

**支援的平台：** Windows (適用於 XBOX 主機工具)

<a id="seealsoSection" />

## 另請參閱

[IXtfCopyFileCallback 介面](/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/ixtfcopyfilecallback-xtffileio-xbox-microsoft-t)\
[XtfFileIO](/zh-TW/reference/tools/xtf/xtffileio/xtffileio-xbox-microsoft-n)


## Related topics

- [IXtfCopyFileCallback::OnFileCopyProgress Method](/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onfilecopyprogress-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfCopyFileCallback::OnFileCopyProgress (método)](/es/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onfilecopyprogress-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfCopyFileCallback::OnFileCopyProgress 메서드](/ko/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onfilecopyprogress-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfCopyFileCallback::OnStartFileCopy Method](/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onstartfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfCopyFileCallback::OnEndFileCopy Method](/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onendfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)