カスタム アクションの Type 34
このカスタム アクションは、コマンド ラインで起動された実行可能ファイルを呼び出します。 詳細については、「実行可能ファイル」を参照してください。
source
実行可能ファイルはファイルから生成されます。 CustomAction テーブルの [Source] フィールドには、Directory テーブルへのキーが含まれます。 参照先の Directory テーブル エントリは、作業ディレクトリへの完全なパスを解決するために使用されます。 これは実行可能ファイルを含むディレクトリへのパスである必要はありません。
Type の値
CustomAction テーブルの [Type] 列に次の値を設定して、基本的な数値の種類を指定します。
| 定数 | 16 進数 | Decimal (10 進数型) |
|---|---|---|
| msidbCustomActionTypeExe + msidbCustomActionTypeDirectory | 0x022 | 34 |
移行先
CustomAction テーブルの [Target] 列には、実行可能ファイルの完全なパスと名前が含まれ、その後に実行可能ファイルへの省略可能な引数が含まれます。 実行可能ファイルの完全なパスと名前が必要です。 長いファイル名またはパスは引用符で囲む必要があります。 値は書式設定されたテキストとして扱われ、プロパティ、ファイル、ディレクトリ、またはその他の書式設定されたテキスト属性への参照を含むことができます。
戻り処理オプション
CustomAction テーブルの [Type] 列に省略可能なフラグ ビットを設定して、戻り処理オプションを指定します。 オプションと値の説明については、「カスタム アクションの戻り処理オプション」をご覧ください。
実行スケジュール オプション
CustomAction テーブルの [Type] 列に省略可能なフラグ ビットを設定して、実行スケジュール オプションを指定します。 これらのオプションはカスタム アクションの複数の実行を制御します。 オプションの説明については、「カスタム アクションの実行スケジュール オプション」をご覧ください。
スクリプト内実行オプション
CustomAction テーブルの [Type] 列に省略可能なフラグ ビットを設定して、スクリプト内実行オプションを指定します。 これらのオプションは、実行、ロールバック、またはコミット スクリプトにアクション コードをコピーします。 オプションの説明については、「カスタム アクションのスクリプト内実行オプション」を参照してください。
戻り値
実行可能ファイルであるカスタム アクションは、成功の場合は値 0 を返す必要があります。 インストーラーはそれ以外の戻り値をすべてエラーと解釈します。 戻り値を無視するには、CustomAction テーブルの [Type] フィールドに msidbCustomActionTypeContinue ビット フラグを設定します。
解説
実行可能ファイルを起動するカスタム アクションは、通常動的に指定されるプロパティが含まれるコマンド ラインを受け取ります。 これが遅延実行カスタム アクションでもある場合、インストール スクリプトからカスタム アクションが呼び出された時点で、インストーラーは CreateProcessAsUser または CreateProcess を使ってプロセスを作成します。
関連トピック