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

# IXtfFileIOClient::CopyFiles Method

> IXtfFileIOClient::CopyFiles Method

# IXtfFileIOClient::CopyFiles Method

在开发主机上的两个位置之间复制文件，并返回有关此操作的信息。

<a id="syntaxSection" />

## 语法

```cpp theme={null}
public:
HRESULT CopyFiles(
         LPCWSTR pszSearchPattern,
         DWORD dwIncludeAttributes,
         DWORD dwExcludeAttributes,
         DWORD dwRecursionLevels,
         LPCWSTR pszDstFileName,
         DWORD dwFlags,
         IXtfCopyFileCallback *pCallback
)  
```

<a id="parametersSection" />

### 参数

*pszSearchPattern*\
类型：LPCWSTR

指向搜索模式的指针，该模式定义要复制的源文件的文件名。此参数接受通配符，以匹配符合指定模式的字符串。

*dwIncludeAttributes*\
类型：DWORD

要包含在复制中的文件属性的按位或组合。有关可能属性的列表，请参阅 [File Attribute Constants](https://msdn.microsoft.com/library/windows/desktop/gg258117\(v=vs.85\).aspx)。

*dwExcludeAttributes*\
类型：DWORD

要从复制中排除的文件属性的按位或组合。有关可能属性的列表，请参阅 [File Attribute Constants](https://msdn.microsoft.com/library/windows/desktop/gg258117\(v=vs.85\).aspx)。

*dwRecursionLevels*\
类型：DWORD

要为复制递归的目录级别数，或者 -1 表示涵盖目录树的所有级别。

*pszDstFileName*\
类型：LPCWSTR

指向要复制到的目标文件的文件名的指针。

*dwFlags*\
类型：DWORD

指定如何复制文件的标志。这是下表中列出的宏的按位或组合。

| 值          | 宏                  | 描述      |
| ---------- | ------------------ | ------- |
| 0x80000000 | XTFCOPYFILE\_DEFER | 延迟文件复制。 |

*pCallback*\
类型：IXtfCopyFileCallback\*

指向 [IXtfCopyFileCallback](/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/ixtfcopyfilecallback-xtffileio-xbox-microsoft-t) 回调的指针，用于在复制状态发生变化时调用。

<a id="retvalSection" />

### 返回值

类型：HRESULT

如果成功，则返回 `S_OK`；否则返回 HRESULT 错误代码。

<a id="remarksSection" />

## 备注

**IXtfFileIOClient::CopyFiles** 启动将文件从 XBOX 主机上的一个位置复制到另一个位置的过程。要跟踪文件复制命令的进度，请使用 [IXtfCopyFileCallback](/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/ixtfcopyfilecallback-xtffileio-xbox-microsoft-t) 的实例来定义回调函数。`IXtfCopyFileCallback` 包含在文件复制操作开始时、进行中以及最后完成后调用的回调函数。\
使用通配符复制多个文件时，*pszDstFileName* 参数被视为一个目录，所有复制的文件都会放入该目录中。如果目录不存在，则在复制文件之前创建它。

*dwIncludeAttributes* 和 *dwExcludeAttributes* 参数用作过滤器，指示要复制哪些文件。这些参数不会用作在复制文件时指示要复制哪些文件属性的过滤器。

<a id="requirementsSection" />

## 要求

**头文件：** xtffileio.h

**库：** xtffileio.lib

**支持的平台：** Windows（用于 XBOX 主机工具）

<a id="seealsoSection" />

## 另请参阅

[IXtfFileIOClient Interface](/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/ixtffileioclient-xtffileio-xbox-microsoft-t)\
[XtfFileIO](/reference/tools/xtf/xtffileio/xtffileio-xbox-microsoft-n)


## Related topics

- [IXtfBatchFileIOClient::CopyFiles Method](/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfBatchFileIOClient/methods/copyfiles-ixtfbatchfileioclient-xtffileio-xbox-microsoft-m.md)
- [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)
- [IXtfCopyFileCallback::OnFileCopyProgress Method](/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onfilecopyprogress-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfFileIOClient::DeleteFiles Method](/zh-CN/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/deletefiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)