カスタム アクションの種類 19

このカスタム アクションは、指定されたエラー メッセージを表示し、エラーを返し、インストールを終了します。 表示されるエラー メッセージは、文字列として、または Error テーブルのインデックスとして指定できます。

source

CustomAction テーブルの Source 列は空にします。

Type の値

CustomAction テーブル の Type 列には、基本的な数値型を指定する次の値を設定します。

定数	16 進数	Decimal (10 進数型)
msidbCustomActionTypeTextData + msidbCustomActionTypeSourceFile	0x013	19

 

移行先

CustomAction テーブルの Target 列には、MsiFormatRecord で指定された機能を使って書式設定されたテキスト文字列が含まれます (数値フィールド指定子は除きます)。 置き換えるパラメーターは角かっこ [...] で囲み、プロパティ、環境変数 (% プレフィックス)、ファイル パス (# プレフィックス)、またはコンポーネント ディレクトリ パス ($ プレフィックス) を指定できます。 書式設定の後で、文字列が整数と評価された場合、その整数が Error テーブルのインデックスとして使用され、表示するメッセージを取得します。 書式設定の後で、文字列に数値以外の文字が含まれている場合は、文字列自体がメッセージとして表示されます。

戻り処理オプション

このカスタム アクションでは、どのオプションも使いません。

実行スケジュール オプション

このカスタム アクションでは、どのオプションも使いません。

スクリプト内実行オプション

このカスタム アクションでは、どのオプションも使いません。

戻り値

「カスタム アクションの戻り値」をご覧ください。

解説

たとえば、カスタム アクション CAError1、CAError2、CAError3、CAError4 によって、次のようなメッセージが返されるとします。

CustomAction テーブル

アクション	Type	source	移行先
CAError1	19		[Prop1]
CAError2	19		Error2 によるインストール エラー。
CAError3	19		25000
CAError4	19		[Prop2]

 

Property テーブル

プロパティ	値
Prop1	"Error1 によるインストール エラー。"
Prop2	"25100"

 

Error テーブル

コード	Message
25000	Error3 によるインストール エラー。
25100	Error4 によるインストール エラー。

 

これらのカスタム アクションによって、次のエラー メッセージが返されます。

カスタム アクション	返されるメッセージ文字列
CAError1	Error1 によるインストール エラー。
CAError2	Error2 によるインストール エラー。
CAError3	Error3 によるインストール エラー。
CAError4	Error4 によるインストール エラー。

 

LaunchCondition テーブルを作成しても起動条件の評価順序を保証できないため、特定の順序で条件を評価するには、カスタム アクションの種類 19 のカスタム アクションを使用する必要があることに注意してください。

関連トピック

Custom_Actions