カスタム アクションの種類 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 アクション 後にシーケンスする必要があります。
関連トピック