カスタム アクションの種類 39
カスタム アクションの種類 39 は、同時インストールで使用されます。 同時実行インストールは、一般へのリリースを目的としたアプリケーションのインストールにはお勧めしません。 同時実行インストールの詳細については、「同時実行インストール」を参照してください。
種類 39 のカスタム アクションでは、アドバタイズまたは既にインストールされているアプリケーションがインストールされます。 このカスタム アクションの種類は、現在の製品のインストール パッケージによって同時インストールとしてインストールされている製品を再インストールまたは削除するために使用できます。 他の方法で以前にインストールした製品を、種類 39 カスタム アクションを使用して再インストールすることも削除することもできません。 たとえば、プライマリ製品のインストール時に種類 39、種類 23、種類 7 のカスタム アクションを使用してセカンダリ製品がインストールされている場合、プライマリ製品がアンインストールされるときにセカンダリ製品を削除するために種類 39 カスタム アクションを使用できます。
source
CustomAction テーブルの Source フィールドには、アプリケーションの製品コードが含まれています。
数値型
| 型名 | 値 |
|---|---|
| msidbCustomActionTypeInstall + msidbCustomActionTypeDirectory | 39 |
移行先
CustomAction テーブルの Target フィールドには、同時実行インストールに渡されるプロパティ設定が含まれています。 これらのプロパティ設定では、機能を指定できます。
戻り処理オプション
アプリケーションがアドバタイズまたはインストールされていない場合、カスタム アクションの種類 39 は失敗します。 この失敗を回避するには、msidbCustomActionTypeContinueflag を設定する必要があります。
同時実行インストールを非同期的に実行することはできません。
「カスタム アクションの戻り処理オプション」を参照してください。
実行スケジュール オプション
オプション フラグを使用して、カスタム アクションの潜在的な複数実行を制御できます。 「カスタム アクション実行スケジュール オプション」を参照してください。
スクリプト内実行オプション
このカスタム アクションでは、このオプションは使いません。
戻り値
同時インストールからのユーザーの終了、失敗、中断、または成功のリターン状態は、他のアクションと同じ方法で処理されます。 ただし、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 | 再起動が必要でしたが、抑制されました。 |
解説
関連付けられているコンポーネントまたは機能のインストールまたは削除で同時インストールを有効にするには、条件式が必要です。
関連トピック