カスタム アクションの種類 23
カスタム アクションの種類 23 は、同時インストールで使用されます。 同時実行インストールは、一般へのリリースを目的としたアプリケーションのインストールにはお勧めしません。 同時実行インストールの詳細については、「同時実行インストール」を参照してください。
このカスタム アクションは、アプリケーションのソース ツリーに存在する別のインストーラー パッケージをインストールします。
source
同時実行インストール パッケージの場所は、CustomAction テーブルの Source フィールドに表示されるソースの場所のルートを基準にして指定されます。
数値型
| 型名 | 値 |
|---|---|
| msidbCustomActionTypeInstall + msidbCustomActionTypeSourceFile | 23 |
移行先
CustomAction テーブルの Target フィールドには、同時実行インストールに渡されるプロパティ設定が含まれています。 これらのプロパティ設定では、機能を指定できます。
戻り処理オプション
同時実行インストール セッションは、現在のプロセスの個別のスレッドとして実行されます。 同時実行インストールを非同期的に実行することはできません。
詳細については、「カスタム アクションの戻り値処理オプション」を参照してください。
実行スケジュール オプション
オプション フラグを使用して、カスタム アクションの潜在的な複数実行を制御できます。 詳細については、「カスタム アクションの実行スケジュール オプション」を参照してください。
スクリプト内実行オプション
使用されていません。
戻り値
同時インストールからのユーザーの終了、失敗、中断、または成功のリターン状態は、他のアクションと同じ方法で処理されます。 ただし、Windows インストーラーは、戻り値をログ ファイルに書き込む際に、すべてのアクションからの戻り値を変換することに注意してください。 たとえば、アクションの戻り値がログ ファイルに "1" と表示される場合、アクションは ERROR_SUCCESS を返したことを意味します。 詳細については、「アクションの戻り値のログ記録」を参照してください。
同時インストールに msidbCustomActionTypeContinue が設定されている場合、ERROR_INSTALL_USEREXIT、ERROR_INSTALL_REBOOT、ERROR_INSTALL_REBOOT_NOW、または ERROR_SUCCESS_REBOOT_REQUIRED が返されると、ERROR_SUCCESS として扱われることに注意してください。 つまり、 msidbCustomActionTypeContinue を設定し、同時実行インストールで再起動が必要な場合、再起動の要件は無視されます。 また、同時実行インストール カスタム アクションのエラー コードは無視されます。
msidbCustomActionTypeContinue が設定されていない場合、次のリターン コードと ERROR_SUCCESS は成功として扱われ、次の意味を持ちます。 その他のリターン コードはエラーとして扱われます。
| メッセージ | 意味 |
|---|---|
| ERROR_INSTALL_REBOOT | インストールの終了時に再起動するように再起動フラグが設定されます。 |
| ERROR_INSTALL_REBOOT_NOW | インストールを完了する前に再起動が必要です。 再起動がすぐに処理されます。 |
| ERROR_SUCCESS_REBOOT_REQUIRED | 再起動が必要でしたが、抑制されました。 |
解説
関連付けられているコンポーネントまたは機能のインストールまたは削除で同時インストールを有効にするには、条件式が必要です。
関連トピック