カスタム アクションの種類 19
このカスタム アクションは、指定されたエラー メッセージを表示し、エラーを返して、インストールを終了します。 表示されるエラー メッセージは、文字列として、または Error テーブルのインデックスとして指定できます。
源
CustomAction テーブルの [ソース] 列 空白のままにします。
型の値
CustomAction テーブルの Type 列に次の値を含め、基本的な数値型を指定します。
定数 | 16 進 数 | 小数 |
---|---|---|
msidbCustomActionTypeTextData + msidbCustomActionTypeSourceFile | 0x013 | 19 |
ターゲット
CustomAction テーブルのターゲット列 には、msiFormatRecordで指定された機能を使用して書式設定されたテキスト文字列含まれています (数値フィールド指定子は使用しません)。 置換するパラメーターは角かっこ [...] で囲まれており、プロパティ、環境変数 (% プレフィックス)、ファイル パス (# プレフィックス)、またはコンポーネント ディレクトリ パス ($ プレフィックス) を指定できます。 文字列の書式設定後に整数に評価された場合、その整数は、表示するメッセージを取得 Error テーブルのインデックスとして使用されます。 書式設定後に文字列に数値以外の文字が含まれている場合は、文字列自体がメッセージとして表示されます。
戻り処理オプション
カスタム アクションでは、オプションは使用されません。
実行スケジュール オプション
カスタム アクションでは、オプションは使用されません。
In-Script 実行オプション
カスタム アクションでは、オプションは使用されません。
戻り値
備考
たとえば、カスタム アクション CAError1、CAError2、CAError3、CAError4 は、これらのメッセージを返します。
CustomAction テーブル の
アクション | 種類 | 源 | ターゲット |
---|---|---|---|
CAError1 | 19 | [Prop1] | |
CAError2 | 19 | Error2 によるインストールエラー。 | |
CAError3 | 19 | 25000 | |
CAError4 | 19 | [Prop2] |
プロパティ テーブル の
財産 | 価値 |
---|---|
Prop1 | "Error1 によるインストール エラー。 |
Prop2 | "25100" |
コード | メッセージ |
---|---|
25000 | Error3 によるインストールエラー。 |
25100 | Error4 によるインストールエラー。 |
これらのカスタム アクションは、次のエラー メッセージを返します。
カスタム アクション | 返されたメッセージ文字列 |
---|---|
CAError1 | Error1 によるインストールエラー。 |
CAError2 | Error2 によるインストールエラー。 |
CAError3 | Error3 によるインストールエラー。 |
CAError4 | Error4 によるインストールエラー。 |
起動条件の評価順序は、LaunchCondition テーブルを作成しても保証できないため、インストールでカスタム アクションの種類 19 カスタム アクションを使用して、特定の順序で条件を評価する必要があります。
関連トピック