> ## 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 メソッド

> IXtfFileIOClient::CopyFiles メソッド

# IXtfFileIOClient::CopyFiles メソッド

開発コンソール上の 2 つの場所間でファイルをコピーし、操作に関する情報を返します。

<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

コピーに含めるファイル属性のビット単位 OR の組み合わせ。指定可能な属性の一覧については、[File Attribute Constants](https://msdn.microsoft.com/library/windows/desktop/gg258117\(v=vs.85\).aspx) を参照してください。

*dwExcludeAttributes*\
型: DWORD

コピーから除外するファイル属性のビット単位 OR の組み合わせ。指定可能な属性の一覧については、[File Attribute Constants](https://msdn.microsoft.com/library/windows/desktop/gg258117\(v=vs.85\).aspx) を参照してください。

*dwRecursionLevels*\
型: DWORD

コピー時に再帰処理するディレクトリの階層数。ディレクトリ ツリー全体を対象にする場合は -1 を指定します。

*pszDstFileName*\
型: LPCWSTR

コピー先のファイル名へのポインター。

*dwFlags*\
型: DWORD

ファイルのコピー方法を指定するフラグ。次の表に示すマクロのビット単位 OR の組み合わせです。

| 値          | マクロ                | 説明                |
| ---------- | ------------------ | ----------------- |
| 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 コンソール上のある場所から別の場所に 1 つまたは複数のファイルをコピーする処理を開始します。ファイル コピー コマンドの進行状況を追跡するには、[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 インターフェイス](/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](/ja-jp/reference/tools/xtf/xtffileio/classes/IXtfBatchFileIOClient/methods/copyfiles-ixtfbatchfileioclient-xtffileio-xbox-microsoft-m.md)
- [IXtfCopyFileCallback::OnStartFileCopy Method](/ja-jp/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onstartfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfCopyFileCallback::OnFileCopyProgress Method](/ja-jp/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onfilecopyprogress-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfFileIOClient::DeleteFiles メソッド](/ja-jp/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/deletefiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [IXtfFileIOClient::FindFiles メソッド](/ja-jp/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/findfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)