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

# CopyFiles 方法

> IXtfBatchFileIOClient::CopyFiles 方法

# IXtfBatchFileIOClient::CopyFiles 方法

在開發主機上的兩個位置之間，批次複製字串清單中列舉的檔案，並傳回作業的相關資訊。

> [!NOTE]
>
> 此方法已淘汰。請改用 [IXtfFileIOClient::CopyFiles](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/copyfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md) 方法。

## 語法

```cpp theme={null}
public:
HRESULT CopyFiles(
         LPCWSTR pszRootDirectory,
         LPCWSTR *rgszRootDirectoryRelativeFiles,
         DWORD cRootDirectoryRelativeFiles,
         LPCWSTR pszDstDirectoryName,
         DWORD dwFlags,
         IXtfCopyFileCallback *pCallback
)  
```

### 參數

*pszRootDirectory*\
類型：LPCWSTR

指向批次複製之根目錄的指標。

*rgszRootDirectoryRelativeFiles*\
類型：LPCWSTR\*

指向字串清單的指標，該清單包含要複製的檔案名稱。

*cRootDirectoryRelativeFiles*\
類型：DWORD

批次複製的檔案數目。

*pszDstDirectoryName*\
類型：LPCWSTR

指向批次複製之目的地目錄名稱的指標。

*dwFlags*\
類型：DWORD

指定如何複製檔案的旗標。此參數是下表所列巨集的位元 OR 組合。

| 值 | 巨集 | 描述 |
| - | - | - |
| 0x80000000 | XTFCOPYFILE\_DEFER | 延遲檔案複製。 |

*pCallback*\
類型：IXtfCopyFileCallback\*

指向 [IXtfCopyFileCallback](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/ixtfcopyfilecallback-xtffileio-xbox-microsoft-t.md) 回呼的指標，當複製狀態變更時就會呼叫此回呼。

### 傳回值

類型：HRESULT

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

## 備註

此函式會以批次作業的方式，在開發主機上的兩個位置之間複製字串清單中列舉的檔案，並傳回作業的相關資訊。

> [!NOTE]
>
> 此方法已淘汰。請改用 [IXtfFileIOClient::CopyFiles](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/copyfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md) 方法。

## 需求

**標頭：** xtffileio.h

**程式庫：** xtffileio.lib

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

## 另請參閱

[IXtfFileIOClient::CopyFiles](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/copyfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)\
[IXtfBatchFileIOClient 介面](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfBatchFileIOClient/ixtfbatchfileioclient-xtffileio-xbox-microsoft-t.md)\
[XtfFileIO](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/xtffileio-xbox-microsoft-n.md)


## Related topics

- [CopyFiles](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/copyfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [XtfFileIO (API 內容)](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/xtffileio-xbox-microsoft-n.md)
- [OnStartFileCopy](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onstartfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfBatchFileIOClient 介面 (介面內容)](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfBatchFileIOClient/ixtfbatchfileioclient-xtffileio-xbox-microsoft-t.md)
- [OnFileCopyProgress](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onfilecopyprogress-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)