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