既定のキュー コールバック ルーチンについて

既定のキュー コールバック ルーチンは、 SetupCommitFileQueue によって送信された通知を汎用的な方法で処理します。 既定のルーチンを使用すると、一般的なセットアップ ダイアログ ボックスを作成するための既製のユーザー インターフェイスを取得できます。 既定のキュー コールバック ルーチンを使用して、使いやすさを確保し、インストール時に生成されるダイアログ ボックスの外観と動作を一貫性のあるものにすることをお勧めします。

既定のコールバック ルーチンには、内部レコードを保持するためのコンテキスト構造が必要です。 さらに、キューは、 パラメーター Param1 と Param2 のセットで、現在の通知に関連する追加情報を渡します。

たとえば、キューが既定のコールバック ルーチンにSPFILENOTIFY_NEEDMEDIA通知を送信する場合、 Param1 は必要なメディアに関する情報を含む SOURCE_MEDIA 構造体を指し、 Param2 はユーザーから新しいパス情報を受信できる文字配列を指します。

既定のコールバック ルーチンでは、この情報を使用して、必要なソース メディアの挿入、新しいパスの指定、現在のファイルのコピーのスキップ、または現在の操作の取り消しをユーザーに求めます。 既定のキュー コールバック ルーチンは、ユーザーが実行したアクションに応じて、キューにFILEOP_NEWPATH、FILEOP_DOIT、FILEOP_SKIP、またはFILEOP_ABORTを返します。

既定のキュー コールバック ルーチンが各キュー通知を処理する方法については、「 ファイル キュー通知」を参照してください。

カスタム キュー コールバック ルーチンの詳細については、「 カスタム キュー コールバック ルーチンの作成」を参照してください。