MsiDatabaseGenerateTransformW 関数 (msiquery.h)

  • [アーティクル]

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

構文

UINT MsiDatabaseGenerateTransformW(
  [in] MSIHANDLE hDatabase,
  [in] MSIHANDLE hDatabaseReference,
  [in] LPCWSTR   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 つのスキーマの唯一の違いは、参照テーブルの末尾に列を追加することです。 主キー列をテーブルに追加したり、ベース テーブルで定義されている既存の列の順序または名前または列定義を変更したりすることはできません。 つまり、どちらのテーブルにもデータが含まれていません。列が参照テーブルから削除された場合、結果のテーブルはベース テーブルと同じです。

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

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

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

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

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

注意

msiquery.h ヘッダーは、MSIDatabaseGenerateTransform をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント 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 インストーラー
対象プラットフォーム Windows
ヘッダー msiquery.h
Library Msi.lib
[DLL] Msi.dll

こちらもご覧ください

データベース管理関数

データベース変換