MsiDatabaseGenerateTransformA 函式 (msiquery.h)

  • 發行項

MsiDatabaseGenerateTransform 函式會產生兩個資料庫之間差異的轉換檔案。 轉換是記錄資料庫變更的方式，而不需要改變原始資料庫。 您也可以使用 MsiDatabaseGenerateTransform 來測試兩個資料庫是否相同，而不需建立轉換。

語法

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 來測試兩個資料庫是否相同，而不需建立轉換。 如果資料庫相同，函式會傳回ERROR_NO_DATA。 如果資料庫不同，函式會傳回NOERROR。

[in] iReserved1

這是保留的自變數，必須設定為0。

[in] iReserved2

這是保留的自變數，必須設定為0。

傳回值

MsiDatabaseGenerateTransform 函式會傳回下列其中一個值：

備註

若要產生兩個資料庫之間的差異檔案，請使用 MsiDatabaseGenerateTransform 函 式。 轉換包含有關插入和刪除資料列和數據列的資訊。 驗證旗標會儲存在轉換檔案的摘要資訊數據流中。

對於存在於這兩個資料庫中的數據表，允許的兩個架構之間唯一的差異是將數據行加入參考數據表的結尾。 您無法將主鍵數據行加入資料表，或變更基表中所定義現有數據行的順序或名稱或資料行定義。 換句話說，如果兩個數據表都未從參考數據表中移除數據和數據行，則產生的數據表與基表相同。

因為轉換的清單分隔符、來源和修補程式是分號，所以不應該將此字元用於檔名或路徑。

此函式不會產生摘要信息數據流。 使用 MsiCreateTransformSummaryInfo 建立現有轉換的數據流。

如果 szTransformFile 為 null，您可以測試兩個資料庫是否相同，而不需建立轉換。 如果資料庫相同，則會傳回ERROR_NO_DATA，如果找到差異，則會傳回 NOERROR。

無法從自定義動作呼叫此函式。 從自定義動作呼叫此函式會導致函式失敗。

如果函式失敗，您可以使用 MsiGetLastErrorRecord 來取得擴充的錯誤資訊。

注意

msiquery.h 標頭會將 MsiDatabaseGenerateTransform 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求 值
最低支援的用戶端 Windows Server 2012、Windows 8、Windows Server 2008 R2 或 Windows 7 上的 Windows Installer 5.0。 Windows Server 2008 或 Windows Vista 上的 Windows Installer 4.0 或 Windows Installer 4.5。 Windows Server 2003 或 Windows XP 上的 Windows Installer
目標平台 Windows
標頭 msiquery.h
程式庫 Msi.lib
Dll Msi.dll

另請參閱

資料庫管理功能

資料庫轉換