InstallExecuteSequence テーブル

ホーム

私訳です。より確かな記述は MSDN (英語)を直接読んで下さい。

MSDN > MSDN Library > Win32 and COM Development > Administration and Management > Application Installation and Servicing > Windows Installer > Windows Installer Reference > Installer Database > Installer Database Reference > Database Tables > InstallExecuteSequence Table

InstallExecuteSequence テーブル

InstallExecuteSequence テーブルは、トップレベル INSTALL action が実行された時に実行されるアクションを記載しています。

InstallValidate action までのインストールシーケンス中のアクションとどの Exit ダイアログボックスも、 InstallUISequence table 中にあります。InstallValidate からインストールシーケンスの終わりまでのすべてのアクションは、InstallExecuteSequence テーブル中にあります。なぜなら、 InstallExecuteSequence テーブルはスタンドアローンである必要があり、 LaunchConditions、 CostInitialize、 FileCost、 CostFinalize アクションと言ったようないくらか必須の初期化アクションを持っているからです。
（訳注： Suggested InstallUISequence と Suggested InstallExecuteSequence を参照して下さい。）

ユーザーインターフェースを必要としている Custom actions は、 Dialog table を使って作成されたダイアログボックスの代わりに MsiProcessMessage を使うべきです。

InstallExecuteSequence テーブルは以下のカラムを持っています。

カラム	タイプ	キー	存在しなくてもよい
Action	Identifier	Yes	No
Condition	Condition	No	Yes
Sequence	Integer	No	Yes

カラム（列）

Action（アクション）

実行するアクションの名前。これはビルトインアクションかカスタムアクションのどちらかです。

プライマリテーブルキー。

Condition（条件）

このフィールドは条件式が入っています。もし式が False に評価されるなら、アクションはスキップされます。もし式のシンタクスが無効なら、iesBadActionData を返してシーケンスは終了します。条件式のシンタクスにおけるインフォメーションに関しては、条件文シンタクス ( Conditional Statement Syntax ) を見て下さい。

Sequence（シーケンス）

このアクションが実行されるべきシーケンス位置を決定する番号。

正の値がシーケンス位置を表しています。値が存在しないとアクションが実行されない事を示しています。続いてくる負の値は、もしインストーラーが結び付けられた終了フラグを返すとこのアクションが実行される事を示しています。それぞれの終了フラグ（負の値）は１つのアクションでしか使用され得ません。多数のアクションが終了フラグを持つ事ができますが、それらは異なったフラグでなければなりません。終了フラグ（負の値）は通常 Dialog Boxes で使用されます。

終了フラグ	値	説明
msiDoActionStatusSuccess	-1	首尾よく完了した。Exit ダイアログボックスと共に使用される。
msiDoActionStatusUserExit	-2	ユーザーがインストールを中断した。UserExit ダイアログボックスと共に使用される。
msiDoActionStatusFailure	-3	致命的なエラーで中断した。FatalError ダイアログボックスと共に使用される。
msiDoActionStatusSuspend	-4	インストールが一時停止されている。