カスタム アクションの種類 2
このカスタム アクションは、コマンド ラインで起動された実行可能ファイルを呼び出します。
源
実行可能ファイルは、一時バイナリ ストリームから生成されます。 CustomAction テーブルの [ソース] フィールド には、バイナリ テーブルのキーが含まれています。 バイナリ テーブルの [データ] 列には、ストリーム データが含まれています。 行ごとに個別のストリームが割り当てられます。
MsiRecordSetStream を使用してファイルから新しいバイナリ データを挿入し、その後に MsiViewModifyしてレコードをテーブルに挿入できます。 カスタム アクションが呼び出されると、ストリーム データが一時ファイルにコピーされ、カスタム アクションの種類に応じて処理されます。
型の値
基本的な数値型を指定する CustomAction テーブルの Type 列に次の値を含めます。
| 定数 | 16 進 数 | 小数 |
|---|---|---|
| msidbCustomActionTypeExe + msidbCustomActionTypeBinaryData | 0x002 | 2 |
ターゲット
CustomAction テーブルのターゲット列 には、ソース列に名前が付けられた実行可能ファイルのコマンド ライン文字列が含まれています。
戻り処理オプション
CustomAction テーブルの Type 列に省略可能なフラグ ビットを含め、戻り処理オプションを指定します。 オプションと値の説明については、「カスタム アクションの戻り値の処理オプション 」を参照してください。
実行スケジュール オプション
CustomAction テーブルの Type 列に省略可能なフラグ ビットを含め、実行スケジュール オプションを指定します。 これらのオプションは、カスタム アクションの複数の実行を制御します。 オプションの詳細については、「カスタム アクション実行スケジュール オプション 」を参照してください。
In-Script 実行オプション
CustomAction テーブルの Type 列に省略可能なフラグ ビットを含め、スクリプト内実行オプションを指定します。 これらのオプションは、アクション コードを実行、ロールバック、またはコミット スクリプトにコピーします。 オプションの詳細については、「カスタム アクション In-Script 実行オプションの 」を参照してください。
戻り値
実行可能ファイル カスタム アクションは、成功するために値 0 を返す必要があります。 インストーラーは、その他の戻り値をエラーとして解釈します。 戻り値を無視するには、customAction テーブルの Type フィールドに msidbCustomActionTypeContinue ビット フラグを設定します。
備考
実行可能ファイルを起動するカスタム アクションはコマンド ラインを受け取ります。コマンド ラインには、一般的に動的に指定されるプロパティが含まれます。 これが 遅延実行カスタム アクションでもある場合、インストーラーは CreateProcessAsUser使用するか、CreateProcessをして、カスタム アクションがインストール スクリプトから呼び出されたときにプロセスを作成します。
データベース テーブルがエクスポートされると、各ストリームは、ファイル名 (バイナリ テーブルの名前列) として主キーを使用し、既定の拡張子が ".ibd" のサブフォルダーに個別のファイルとして書き込まれます。 ファイル システムまたはバージョン管理システムが長いファイル名をサポートしていない場合は、名前に 8.3 形式を使用する必要があります。 永続アーカイブ ファイルは、ストリーム データを使用したファイル名に置き換え、テーブルのインポート時にデータを見つけられます。
関連トピック