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

このカスタム アクションは、コマンド ラインで起動された実行可能ファイルを呼び出します。

源

実行可能ファイルは、アプリケーションと共にインストールされたファイルから生成されます。 CustomAction テーブルの [ソース] フィールド には、ファイル テーブルのキーが含まれています。 カスタム アクション コードの場所は、このファイルのターゲット パスの解決によって決まります。そのため、このカスタム アクションは、ファイルがインストールされた後、削除される前に呼び出す必要があります。

型の値

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

ターゲット

CustomAction テーブルのターゲット列 には、ソース列で識別される実行可能ファイルのコマンド ライン文字列が含まれています。

戻り処理オプション

戻り値の処理オプションを指定するために、CustomAction テーブルの の Type 列に省略可能なフラグ ビットを含めます。 オプションと値の説明については、「カスタム アクションの戻り値の処理オプション 」を参照してください。

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

実行スケジュール オプションを指定するために、CustomAction テーブルの の Type 列に省略可能なフラグ ビットを含めます。 これらのオプションは、カスタム アクションの複数の実行を制御します。 オプションの詳細については、「カスタム アクション実行スケジュール オプション 」を参照してください。

In-Script 実行オプション

スクリプト内実行オプションを指定するために、CustomAction テーブルの の Type 列に省略可能なフラグ ビットを含めます。 これらのオプションは、アクション コードを実行、ロールバック、またはコミット スクリプトにコピーします。 オプションの詳細については、「カスタム アクション In-Script 実行オプションの 」を参照してください。

戻り値

実行可能ファイル カスタム アクションは、成功するために値 0 を返す必要があります。 インストーラーは、その他の戻り値をエラーとして解釈します。 戻り値を無視するには、customAction テーブルの Type フィールドに msidbCustomActionTypeContinue ビット フラグを設定します。

備考

実行可能ファイルを起動するカスタム アクションはコマンド ラインを受け取ります。コマンド ラインには、一般的に動的に指定されるプロパティが含まれます。 これが 遅延実行カスタム アクションでもある場合、インストーラーは CreateProcessAsUser使用するか、CreateProcessをして、カスタム アクションがインストール スクリプトから呼び出されたときにプロセスを作成します。

インストールされているファイルをソースとして参照するカスタム アクション (Custom Action Type 18 (EXE) など) は、次のシーケンス制限に従う必要があります。

• カスタム アクションは、CostFinalize アクションの後にシーケンスする必要があります。 これは、EXE を見つけるために必要なパスをカスタム アクションで解決できるようにするためです。
• ソース ファイルがコンピューターにまだインストールされていない場合は、この種類の遅延 (スクリプト内) カスタム アクションは、InstallFiles アクション後にシーケンスする必要があります。
• ソース ファイルがまだコンピューターにインストールされていない場合は、この種類の非遅延カスタム アクションは、installFinalize アクション 後にシーケンスする必要があります。

関連トピック

Custom_Actions

実行可能ファイルの