Database.ApplyTransform メソッド

  • [アーティクル]

Database オブジェクトの ApplyTransform メソッドは、このデータベースに変換を適用します。

構文

Database.ApplyTransform(
  storage,
  errorConditions
)

パラメーター

storage

適用される変換ファイルへのパス。 このパラメーターは必須です。

errorConditions

抑制するエラー条件を指定します。 次の整数値の組み合わせとして指定します。

エラー状態 説明
msiTransformErrorAddExistingRow
0x0001
 既に存在する行を追加します。
msiTransformErrorDeleteNonExistingRow
0x0002
 存在しない行を削除します。
msiTransformErrorAddExistingTable
0x0004
 既に存在するテーブルを追加します。
msiTransformErrorDeleteNonExistingTable
0x0008
 存在しないテーブルを削除します。
msiTransformErrorUpdateNonExistingRow
0x0010
 存在しない行を更新します。
msiTransformErrorChangeCodePage
0x0020
 変換とデータベースのコード ページが一致せず、どちらにもニュートラルなコード ページがありません。
msiTransformErrorViewTransform
0x0100
 一時 _TransformView テーブルを作成します。

戻り値

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

解説

ApplyTransform メソッドは、可能な限り最後の時点までテーブルの変換を遅らせます。 ApplyTransform で実行する手順は、データベースのテーブル カタログと列カタログをすぐに変換することです。 どのテーブルが追加または削除され、どの列が追加されるかに応じて、テーブル カタログと列カタログが更新されます (列の削除は許可されません)。 テーブルが現在メモリに読み込まれ、変換が必要な場合は、変換されます。 それ以外の場合、テーブルの状態は変換を必要とする状態に設定されるため、テーブルが読み込まれる際、またはデータベースがコミットされる際に変換が適用されます。 このインスタンスの変換は、テーブルの実際の (行) データが追加、削除、または更新されることを意味します。

メソッドが失敗した場合は、LastErrorRecord メソッドを使用して拡張エラー情報を取得できます。

必要条件

要件 値
バージョン
 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 と義されている

こちらもご覧ください

データベース

データベース変換