次の方法で共有


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

このカスタム アクションは VBScript で記述されます。 スクリプト も参照してください。

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

型の値

32 ビット カスタム アクションの基本的な数値型を指定するには、CustomAction テーブル の Type 列に次の値を含めます。

定数 16 進 数 小数
msidbCustomActionTypeVBScript + msidbCustomActionTypeSourceFile 0x016 22

 

Windows インストーラーでは、64 ビット オペレーティング システムで 64 ビット カスタム アクションを使用できます。 スクリプトに基づく 64 ビットのカスタム アクションでは、msidbCustomActionType64BitScript ビットを数値型に含める必要があります。 詳細については、「64 ビット カスタム アクションの」を参照してください。 64 ビット カスタム アクションの基本的な数値型を指定するには、CustomAction テーブルの の Type 列に次の値を含めます。

定数 16 進 数 小数
msidbCustomActionTypeVBScript + msidbCustomActionTypeSourceFile + msidbCustomActionType64BitScript 0x0001016 4118

 

ターゲット

CustomAction テーブルの [ターゲット] フィールド には、オプションのスクリプト関数が含まれています。 処理は、最初に解析用のスクリプトを送信してから、オプションのスクリプト関数を呼び出します。

戻り処理オプション

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

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

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

In-Script 実行オプション

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

戻り値

スクリプトで記述された省略可能な関数は、「JScript と VBScript カスタム アクションの戻り値 で説明されている値のいずれかを返す必要があります。

備考

JScript または VBScript で記述されたカスタム アクションには、セッション オブジェクトインストールする必要があります。 これはセッション オブジェクト の種類で、インストーラーによって "Session" という名前のスクリプトにアタッチされます。 Session オブジェクトはインストールのロールバック中に存在しない可能性があるため、スクリプトで記述された遅延カスタム アクションでは、「遅延実行カスタム アクションのコンテキスト情報の取得 」セクションで説明されている Session オブジェクトのメソッドまたはプロパティのいずれかを使用して、そのコンテキストを取得する必要があります。

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

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

Custom_Actions