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

# OnDeployFileProgress

> IXtfDeployCallback::OnDeployFileProgress

# IXtfDeployCallback::OnDeployFileProgress

本体へのファイルのデプロイの進行状況を報告するために呼び出されるコールバックです。

## 構文

```cpp theme={null}
public:
HRESULT OnDeployFileProgress(
         LPCWSTR pszFilePath,
         ULONGLONG ullBytesTransferred,
         ULONGLONG ullFileSize
)  
```

### パラメーター

*pszFilePath*\
型: LPCWSTR

デプロイされているファイルのパスです。

*ullBytesTransferred*\
型: ULONGLONG

これまでに転送されたバイト数です。

*ullFileSize*\
型: ULONGLONG

転送されているファイルの合計サイズ (バイト単位) です。

### 戻り値

型: HRESULT

デプロイを続行するには `S_OK` を、デプロイをキャンセルするには HRESULT エラー コードを返します。

## 解説

このコールバックは、デプロイ システムがファイルをデプロイ元の PC から本体に転送するときに呼び出されます。 このコールバックは、ファイルに対して正常に転送されたバッファー ブロックごとに 1 回呼び出されます。 このコールバックは、正常に転送された各ファイルに対して少なくとも 2 回呼び出されます。デプロイの開始時に 1 回、デプロイの終了時に 1 回です。 ゼロ長のファイルがデプロイされた場合、両方の呼び出しでゼロ バイトのうちゼロ バイトが転送されたと報告されます。 デプロイ プロセス中にファイルがどのように評価され、コールバックがいつ呼び出されるかの詳細については、[IXtfDeployCallback インターフェイス](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/ixtfdeploycallback-xtfapplication-xbox-microsoft-t.md) を参照してください。

> [!NOTE]
>
> デプロイのためのファイル転送プロセスは、複数のスレッドを使用します。 コードは、`pszFilePath` によって進行状況メッセージを関連付け、一般的なマルチスレッドの問題から保護する必要があります。

`IXtfDeployCallback` の他のコールバックと同様に、このコールバックが `S_OK` を返すとデプロイ プロセスは続行します。 このコールバックが `HRESULT` エラー コードを返すと、デプロイ プロセスは直ちにキャンセルされます。 既に転送または削除されたファイルはそのまま残り、部分的に転送されたファイルは切り詰められた形式で閉じられます。 本体上のすべてのファイルが完全で最新であることを確認するには、別のデプロイを完了する必要があります。

## 要件

**ヘッダー:** xtfapplication.h

**ライブラリ:** xtfapplication.lib

**サポートされているプラットフォーム:** Windows (XBOX 本体ツール用)

## 関連項目

[IXtfDeployCallback インターフェイス](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/ixtfdeploycallback-xtfapplication-xbox-microsoft-t.md)\
[XtfApplication](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapplication/xtfapplication-xbox-microsoft-n.md)


## Related topics

- [IXtfDeployCallback インターフェイス (インターフェイスの内容)](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/ixtfdeploycallback-xtfapplication-xbox-microsoft-t.md)
- [Deploy](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/deploy-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)
- [OnDeployExtraFileDetected](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafiledetected-ixtfdeploycallback-xtfapplication-x.md)
- [OnDeployExtraFileRemoved](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapplication/classes/IXtfDeployCallback/methods/ondeployextrafileremoved-ixtfdeploycallback-xtfapplication-xb.md)
- [OnFileCopyProgress](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtffileio/classes/IXtfCopyFileCallback/methods/onfilecopyprogress-ixtfcopyfilecallback-xtffileio-xbox-microsoft-m.md)