InstallFiles アクション
InstallFiles アクションは、ファイル テーブルで指定されたファイルをソース ディレクトリからコピー先ディレクトリにコピーします。
シーケンスの制限
InstallFiles アクションは、InstallValidate アクションの後、およびファイルに依存するアクションの前に行う必要があります。
ActionData のメッセージ
| フィールド | アクション データの説明 |
|---|---|
| [1] | インストールされているファイルの識別子。 |
| [6] | インストール対象のファイルのサイズ (バイト単位)。 |
| [9] | インストールされているファイルを保持しているディレクトリの識別子。 |
解説
InstallFiles アクションは、ファイル テーブルで指定されたファイルに対して動作します。 各ファイルは、コンポーネント テーブル内のファイルに関連付けられているコンポーネントのインストール状態に基づいてインストールされます。 コンポーネントが msiInstallStatelocal 状態に解決済みのファイルのみがコピーの対象となります。
InstallFiles アクションは、ファイル テーブルの次の列を実装します。
- [FileName] 列は、ターゲット ファイル名を指定します。
- [Version] 列は、ファイルのバージョンを指定します。
- [Attributes] 列は、ファイルおよびインストール属性フラグ ビットを指定します。
- [File] 列は、一意のファイル トークンを指定します。
- [FileSize] 列は、圧縮されていないファイル サイズをバイト単位で指定します。
- [Language] 列は、ファイル言語識別子を指定します。
- [Sequence] 列は、メディアのシーケンス番号を指定します。
InstallFiles アクションは、コンポーネント テーブルの次の列を実装します。
- [Directory_] 列は、ディレクトリ テーブル項目への参照を指定します。
- [Component] 列は、コンポーネント項目の一意の名前を指定します。
指定されたファイルは、次のいずれか 1 つに当てはまる場合にのみコピーされます。
- ファイルが現在ローカル コンピューターにインストールされていない。
- ファイルはローカル コンピューター上にあるが、ファイル テーブルのファイルよりも小さいバージョン番号である。
- ファイルはローカル コンピューター上にあるが、関連付けられているバージョン番号はない。
コピーする各ファイルのソース ディレクトリは sourceMode によって決まります。これは、メディア テーブルの [Cabinet] 列の値によって異なります。 ソース モードの詳細については、「メディア テーブル」をご覧ください。
コピーするファイルのソース ディレクトリがフロッピー ディスクや CD-ROM などのリムーバブル メディアに存在する場合、InstallFiles アクションでは、ファイルのコピーを試みる前に、適切なソース メディアが挿入されていることが確認されます。 InstallFiles により、メディア テーブルの [VolumeLabel] 列に指定された値と一致する "ボリューム" ラベルを持つ同じリムーバブル型のメディアが検索されます。 一致するマウント済みのボリュームが見つかった場合は、ファイルのコピー処理が続行されます。 一致するものが見つからない場合、ダイアログ ボックスはユーザーに適切なメディアの挿入を要求します。 この場合、ダイアログ ボックスでは、プロンプトの一部としてメディア テーブルの [DiskPrompt] 列にあるメディア名が使用されます。
InstallFiles アクションにより、元のファイルが削除され置き換えられないことがあるため、注意が必要です。 これは、InstallFiles アクションにより古いファイルが置き換えられる際にエラーが発生し、ユーザーがエラーを無視することを選択した場合に発生します。 インストーラーの既定の動作では、新しいファイルが正しくコピーされるようにする前に、古いファイルが削除されます。
インストーラーで使用されるファイルのバージョン管理規則については、「ファイルのバージョン管理規則」をご覧ください。