Database.CreateTransformSummaryInfo メソッド

Database オブジェクトの CreateTransformSummaryInfo メソッドは、既存の変換ファイルのサマリー情報ストリームを作成して設定します。 このメソッドは、プロパティに基本および参照 ProductCode と ProductVersion を入力します。

構文

Database.CreateTransformSummaryInfo(
  reference,
  storage,
  errorConditions,
  validation
)

パラメーター

reference

変更を含まない必須データベース。

storage

生成される変換ファイルの名前。 これは省略可能です。

errorConditions

変換の適用時に抑制する必要がある必須のエラー条件。 次のエラー条件値の 1 つ以上を結合します。

エラー条件名 説明
msiTransformErrorNone
0
 次の条件のいずれにも該当しません。
msiTransformErrorAddExistingRow
1
 既に存在する行を追加します。
msiTransformErrorDeleteNonExistingRow
2
 存在しない行を削除します。
msiTransformErrorAddExistingTable
4
 既に存在するテーブルを追加します。
msiTransformErrorDeleteNonExistingTable
8
 存在しないテーブルを削除します。
msiTransformErrorUpdateNonExistingRow
16
 存在しない行を更新します。
msiTransformErrorChangeCodepage
32
 変換とデータベース のコード ページが一致せず、どちらのコード ページもニュートラルではありません。

validation

変換がデータベースに適用される場合は必須です。この変換をデータベースに適用できることを確認するために検証する必要があるプロパティを示します。 プロパティはすべて、Summary Information Stream プロパティ セットに含まれています。

次の値の 1 つ以上を結合します。

検証フラグ 説明
msiTransformValidationNone
0
 検証が行われません。
msiTransformValidationLanguage
1
 既定の言語が基本データベースと一致していなければなりません。
msiTransformValidationProduct
2
 製品が基本データベースと一致していなければなりません。

製品バージョンを検証するには、まず、これら 3 つのフラグのうち 1 つ以上を選択して、どれだけのバージョンを検証するかを示します。

検証フラグ 説明
msiTransformValidationMajorVer
8
 メジャー バージョンのみを確認します。
msiTransformValidationMinorVer
16
 メジャーおよびマイナーバージョンのみを確認します。
msiTransformValidationUpdateVer
32
 メジャー、マイナー、および更新バージョンを確認します。

次に、次のいずれかを選択して、変換を適用しているデータベースの製品バージョンと基本データベースの製品バージョンとの間の必要な関係を示します。

検証フラグ 説明
msiTransformValidationLess
64
 適用されたバージョン < 基本バージョン
msiTransformValidationLessOrEqual
128
 適用されたバージョン <= 基本バージョン
msiTransformValidationEqual
256
 適用されたバージョン = 基本バージョン
msiTransformValidationGreaterOrEqual
512
 適用されたバージョン >= 基本バージョン
msiTransformValidationGreater
1024
 適用されたバージョン > 基本バージョン

適切な UpgradeCode を持つパッケージに変換が適用されていることを検証するには、次のフラグを設定します。

検証フラグ 説明
msiTransformValidationUpgradeCode
2048
 変換が適切な UpgradeCode であることを検証します。

戻り値

このメソッドは値を返しません。

解説

変換のサマリー情報ストリームを作成するには、ProductCode プロパティと ProductVersionプロパティを基本データベースと参照データベース両方の Property テーブルで定義する必要があります。 msiTransformValidationUpgradeCode を使用する場合、 UpgradeCode プロパティは両方のデータベースで定義する必要があります。

必要条件

要件 値
バージョン
 Windows Server 2012、Windows 8、Windows Server 2008 R2、または Windows 7 の Windows インストーラー 5.0。 Windows Server 2008 または Windows Vista の Windows インストーラー 4.0 または Windows インストーラー 4.5。 Windows Server 2003 または Windows XP の Windows インストーラー
[DLL]
Msi.dll
IID
 IID_IDatabase が 000C109D-0000-0000-C000-000000000046 と義されている

こちらもご覧ください

データベース変換

  • Last updated on