キュー コミットメントの順序
SetupCommitFileQueue 関数がファイル キューをコミットすると、ファイルの削除操作、ファイル名の変更操作、最後にファイルのコピー操作の順序でファイル操作が処理されます。 次のアウトラインは、キューのコミットメント プロセスのライフ サイクルを示しています。
- 削除サブキューを開始する
- <ファイル削除操作を開始します。それぞれについて繰り返します。
- ファイル削除操作を完了 <-- キューに登録されたファイルの削除
- 削除サブキューを完了する
- 名前の変更サブキューを開始する
- <ファイル名の変更操作を開始します。
- <ファイルの削除操作を完了する -- キューに登録されたファイル名の変更
- 名前の変更サブキューを完了する
- コピー サブキューを開始する
- <ファイル コピー操作を開始します。それぞれについて繰り返します。
- ファイル コピー操作を完了 <-- キューに登録されたファイル コピー
- コピー サブキューを完了する
- キューを完了する
各ステップで、またはエラーが発生した場合、SetupCommitFileQueue 関数はコールバック ルーチンに通知を送信します。 コールバック ルーチンは、キューによって送信された情報を使用してインストールの進行状況を追跡し、必要に応じてユーザーと対話できます。
たとえば、ファイル コピー操作で、現在のパスで使用できなかったソース ファイルが必要な場合、SetupCommitFileQueueは、必要なファイルとメディアに関する情報と共に、SPFILENOTIFY_NEEDMEDIA通知をコールバック ルーチンに送信します。 コールバック ルーチンは、この情報を使用して、SetupPromptForDiskを呼び出して次のディスク挿入するようにユーザーに求めるダイアログ ボックスを生成できます。
SetupDefaultQueueCallback既定のキュー コールバック ルーチンは、セットアップ API に含まれています。 このルーチンは、キュー通知を処理し、インストールのエラー ダイアログ ボックスと進行状況バーを生成します。 既定のキュー コールバック ルーチンをそのまま使用するか、フィルター コールバック ルーチンを記述して通知のサブセットを処理し、他のルーチンを既定のキュー コールバック ルーチンに渡すことができます。
コールバック ルーチンのどの機能もニーズに合わない場合は、既定のキュー コールバック ルーチンを呼び出さない自己完結型のカスタム コールバック ルーチンを記述できます。
キュー コールバック ルーチンの詳細については、「既定のキュー コールバック ルーチンの」および「カスタム キュー コールバック ルーチンの作成」を参照してください。