次の方法で共有

カスタム アクションの種類 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