IXtfDeployCallback インターフェイス
IXtfApplicationClient::Deploy 操作中に追跡可能なアクションが発生したときに呼び出されるコールバックを提供します。構文
メソッド
解説
すべてのコールバック メソッドは、その戻り値に関して同じように動作します。 コールバックが成功した HResult を返すと、デプロイ プロセスは続行します。 コールバックが失敗した HResult を返すと、デプロイ プロセスは直ちにキャンセルされます。 既に転送または削除されたファイルはそのまま残り、部分的に転送されたファイルは切り詰められた形式で閉じられます。 コールバック プロセスは単純です。 デプロイ中の開発 PC 上の各ファイルは、対象の本体上の対応するファイルと比較されます。- PC と本体でファイルが同じ場合、それ以上の処理は行われません。
- PC 上のファイルが本体上のファイルよりも新しい場合、そのファイルは PC から本体にコピーされます。
- ファイルが PC 上に存在し、本体上に存在しない場合、そのファイルは本体にコピーされます。
- ファイルが本体上に存在し、PC 上に存在しない場合、そのファイルは必要に応じて本体から削除されます。 (削除するかどうかは、Deploy の fRemoveExtraFiles パラメーターの値によって決まります)。
- OnDeployInitialized: このコールバックは、デプロイ システムが動作を開始したときに呼び出され、デプロイの計時を開始したり、進行状況ダイアログを初期化したりするために使用できます。 このコールバックが呼び出されると、すべての潜在的な相互運用と DLL 境界の交差が正常に完了しています。 このコールバックはデプロイごとに 1 回呼び出されます。
- OnDeployChangeEvaluation: このコールバックは、デプロイ システムが本体にデプロイする必要があるファイルまたは本体から削除するファイルを評価するときに呼び出されます。 このコールバックを使用して、進行状況インジケーターを更新できます。
- OnDeployMetrics: このコールバックは、評価プロセスの最後に 1 回呼び出され、本体にデプロイされるファイル数と転送される合計バイト数を報告します。
- OnDeployFileProgress: このコールバックは、ファイルごとにバッファー ブロックが正常に転送されるたびに呼び出されます。 転送は複数のスレッドで同時に実行されるため、コードはファイル名で進行状況を追跡し、通常のマルチスレッドの問題から保護する必要があります。 このコールバックは、転送の開始時と終了時に 1 回ずつ呼び出されるため、ゼロ長のファイルではこのコールバックが 2 回呼び出されます。
- OnDeployExtraFileDetected: PC 上にないファイルが本体上で見つかったことを示します。
- OnDeployExtraFileRemoved: Deploy の fRemoveExtraFiles パラメーターが TRUE に設定されていた場合、このコールバックは本体からファイルが削除されたときに呼び出されます。
- OnDeployError は現在の実装では使用されていませんが、将来の使用のために予約されています。