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

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

source

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

Type の値

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

移行先

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

戻り処理オプション

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

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

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

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

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

戻り値

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

解説

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

CustomAction テーブル

Property テーブル

Error テーブル

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

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

関連トピック

Custom_Actions