> ## 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 Method

> IXtfCopyFileCallback::OnFileCopyProgress Method

# IXtfCopyFileCallback::OnFileCopyProgress Method

在文件复制进度发生变化时调用。

<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](/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 Interface](/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/ixtfcopyfilecallback-xtffileio-xbox-microsoft-t)\
[XtfFileIO](/reference/tools/xtf/xtffileio/xtffileio-xbox-microsoft-n)


## Related topics

- [IXtfCopyFileCallback::OnEndFileCopy Method](/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onendfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfCopyFileCallback::OnStartFileCopy Method](/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onstartfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfBatchFileIOClient::CopyFiles Method](/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfBatchFileIOClient/methods/copyfiles-ixtfbatchfileioclient-xtffileio-xbox-microsoft-m.md)
- [IXtfFileIOClient::CopyFiles Method](/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/copyfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [XTFFILEINFO](/zh-CN/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t.md)