MsiDatabaseGenerateTransformA 関数 (msiquery.h)

MsiDatabaseGenerateTransform 関数は、2 つのデータベース間の相違点の変換ファイルを生成します。 変換は、元のデータベースを変更せずにデータベースへの変更を記録する方法です。 MsiDatabaseGenerateTransform を使用して、変換を作成せずに 2 つのデータベースが同一かどうかをテストすることもできます。

構文

UINT MsiDatabaseGenerateTransformA(
  [in] MSIHANDLE hDatabase,
  [in] MSIHANDLE hDatabaseReference,
  [in] LPCSTR    szTransformFile,
  [in] int       iReserved1,
  [in] int       iReserved2
);

パラメーター

[in] hDatabase

変更を含む MsiOpenDatabase から取得したデータベースを処理します。

[in] hDatabaseReference

変更を含まない MsiOpenDatabase から取得したデータベースを処理します。

[in] szTransformFile

生成される変換ファイルの名前を指定する null で終わる文字列。 このパラメーターには、null を指定できます。 szTransformFile が null の場合は、MsiDatabaseGenerateTransform を使用して、変換を作成せずに 2 つのデータベースが同一かどうかをテストできます。 データベースが同一の場合、関数は ERROR_NO_DATAを返します。 データベースが異なる場合、関数は NOERROR を返します。

[in] iReserved1

これは予約済み引数であり、0 に設定する必要があります。

[in] iReserved2

これは予約済み引数であり、0 に設定する必要があります。

戻り値

MsiDatabaseGenerateTransform 関数は、次のいずれかの値を返します。

注釈

2 つのデータベース間で差分ファイルを生成するには、 MsiDatabaseGenerateTransform 関数を使用します。 変換には、列と行の挿入と削除に関する情報が含まれています。 検証フラグは、変換ファイルの概要情報ストリームに格納されます。

両方のデータベースに存在するテーブルの場合、許可される 2 つのスキーマの唯一の違いは、参照テーブルの末尾に列を追加することです。 主キー列をテーブルに追加したり、ベース テーブルで定義されている既存の列の順序や名前または列定義を変更したりすることはできません。 つまり、どちらのテーブルにもデータが含まれており、列が参照テーブルから削除される場合、結果のテーブルはベース テーブルと同じです。

変換、ソース、パッチのリスト区切り記号はセミコロンであるため、ファイル名またはパスにはこの文字を使用しないでください。

この関数では、Summary Information ストリームは生成されません。 MsiCreateTransformSummaryInfo を使用して、既存の変換のストリームを作成します。

szTransformFile が null の場合は、変換を作成せずに 2 つのデータベースが同一かどうかをテストできます。 データベースが同一の場合、ERROR_NO_DATAが返され、相違点が見つかった場合は NOERROR が返されます。

この関数は、カスタム アクションから呼び出すことはできません。 カスタム アクションからこの関数を呼び出すと、関数は失敗します。

関数が失敗した場合は、 MsiGetLastErrorRecord を使用して拡張エラー情報を取得できます。

要件

こちらもご覧ください

データベース管理関数

データベース変換