> ## 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::OnStartFileCopy Method](/ja-jp/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onstartfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfCopyFileCallback::OnEndFileCopy Method](/ja-jp/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onendfilecopy-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)
- [IXtfBatchFileIOClient::CopyFiles Method](/ja-jp/reference/tools/xtf/xtffileio/classes/IXtfBatchFileIOClient/methods/copyfiles-ixtfbatchfileioclient-xtffileio-xbox-microsoft-m.md)
- [IXtfFileIOClient::CopyFiles メソッド](/ja-jp/reference/tools/xtf/xtffileio/classes/IXtfFileIOClient/methods/copyfiles-ixtffileioclient-xtffileio-xbox-microsoft-m.md)
- [XTFFILEINFO](/ja-jp/reference/tools/xtf/xtffileio/structures/xtffileinfo-xtffileio-xbox-microsoft-t.md)