InstallValidate アクション
InstallValidate アクションは、コスト が発生したすべてのボリュームに、インストールに十分な領域があることを確認します。 InstallValidate アクションは、ボリュームにディスク領域が不足している場合、致命的なエラーでインストールを終了します。
InstallValidate アクションは、上書きまたは削除する 1 つ以上のファイルがアクティブなプロセスで現在使用されている場合にもユーザーに通知します。 詳細については、「システム再起動 を参照してください。
シーケンスの制限
CostFinalize アクションと、ユーザーが選択状態やディレクトリを変更できるようにする UI ダイアログ ボックス シーケンスは、InstallValidate アクションの前にシーケンスする必要があります。
機能またはコンポーネントのインストール状態を変更するカスタム アクション は、InstallValidate アクションの前にシーケンスする必要があります。
ActionData メッセージ
ActionData メッセージはありません。
備考
通常、以前の UI ダイアログ ボックス シーケンスは、ユーザーがファイルのコピーを開始しようとしたときに InstallValidate アクションと同じ検証を実行する必要があります。 選択したボリュームにインストール用の十分な領域がない場合、この UI ダイアログ ボックス のシーケンスでは、ディスク領域不足 ダイアログ ボックスが表示されます。 十分なディスク領域がない場合にユーザーがインストールを続行できないように、UI ダイアログ ボックスを作成する必要があります。 静かなインストールの場合、ユーザー インターフェイスがなく、ディスク領域が不足している場合、InstallValidate アクションによってインストールが終了します。 早期終了の原因は、ログ記録が有効になっている場合にログ ファイルに記録されます。
ファイル コストの中に、ファイルが実行または変更のために開かれている間にファイルが上書きまたは削除された場合、エントリは内部 FilesInUse テーブルに追加されます。 FilesInUse テーブルには、ファイルの名前と完全なパスの列が含まれています。 InstallValidate アクションが実行されると、インストーラーは FilesInUse テーブルにエントリを照会し、ファイルを使用してプロセスの名前を決定します。 InstallValidate アクションは、このクエリによって識別される一意のプロセスごとに、ListBox ユーザー インターフェイス テーブルに 1 つのレコードを追加します。 レコードには、各列に次の値が含まれています。
プロパティ: FileInUseProcess
値の: プロセス の名前
テキスト: プロセス のメイン ウィンドウのキャプションに含まれるテキストを します。
InstallValidate アクションは、ファイルの使用中 ダイアログ ボックスを表示します。 このダイアログ ボックスには、使用中のファイルを置き換えるためにシステムを再起動する必要がないように、シャットダウンする必要があるプロセスが表示されます。
InstallValidate アクションは、ダイアログ テーブルに対して、FilesInUse ダイアログ 予約名を使用して作成されたダイアログ ボックスを照会し、表示します。 このダイアログ ボックスには、FileInUseProcess という名前のプロパティに関連付けられている ListBox コントロールが含まれている必要があります。 慣例により、このダイアログ ボックスには Exit、Retry、または Ignore ボタンがありますが、これは UI 作成者にかかっています。 各ボタンは、ControlEvent テーブルの EndDialog ControlEvent に関連付ける必要があります。 InstallValidate アクションは、DoAction ControlEvent によって返される値に次のように応答します。これは、ユーザーがプッシュしたボタンに関連付けられているこれらの EndDialog 引数のいずれかによって指定されます。
再試行: ListBox テーブルに追加されたすべての値がクリアされ、ファイル全体 コスト プロシージャが繰り返され、まだ使用中のファイルが再確認されます。 1 つ以上のプロセスが上書きまたは削除されるファイルを使用しているとして識別された場合、プロセスは繰り返されます。それ以外の場合、InstallValidate は msiDoActionStatusSuccess の状態でインストーラーに制御を返します。
Exit: InstallValidate アクションは、msiDoActionStatusUserExit の状態ですぐにインストーラーに制御を返します。 これにより、インストールが終了します。
他の戻り値: InstallValidate アクションは、msiDoActionStatusSuccess の状態ですぐにインストーラーに制御を返します。 この場合、1 つ以上のファイルがまだ使用されているため、InstallFiles または installAdminPackage アクション 後続の は、システムの再起動時に使用中のファイルの置換または削除をスケジュールする必要があります。
データベースに listBox テーブル がない場合、InstallValidate はエラーなしでサイレント終了します。
セミコロンは変換、ソース、およびパッチのリスト区切り記号であり、これらのファイル名またはパスでは使用しないでください。
読み取り専用の場所で読み取り専用としてマークされたファイルは、インストーラーによって使用されているとは見なされません。
ユーザー インターフェイス レベルが基本の場合、[ の中止] ボタンと [再試行] ボタンを含む既定の [ディスク領域不足] ダイアログ ボックスがユーザーに表示されます。