Fungsi MsiDatabaseApplyTransformA (msiquery.h)

  • Artikel

Fungsi MsiDatabaseApplyTransform menerapkan transformasi ke database.

Sintaks

UINT MsiDatabaseApplyTransformA(
  [in] MSIHANDLE hDatabase,
  [in] LPCSTR    szTransformFile,
  [in] int       iErrorConditions
);

Parameter

[in] hDatabase

Tangani ke database yang diperoleh dari MsiOpenDatabase ke transformasi.

[in] szTransformFile

Menentukan nama file transformasi yang akan diterapkan.

[in] iErrorConditions

Kondisi kesalahan yang harus ditekan. Parameter ini adalah bidang bit yang dapat berisi bit berikut.

Kondisi kesalahan Makna
MSITRANSFORM_ERROR_ADDEXISTINGROW
0x0001
 Menambahkan baris yang sudah ada.
MSITRANSFORM_ERROR_DELMISSINGROW
0x0002
 Menghapus baris yang tidak ada.
MSITRANSFORM_ERROR_ADDEXISTINGTABLE
0x0004
 Menambahkan tabel yang sudah ada.
MSITRANSFORM_ERROR_DELMISSINGTABLE
0x0008
 Menghapus tabel yang tidak ada.
MSITRANSFORM_ERROR_UPDATEMISSINGROW
0x0010
 Memperbarui baris yang tidak ada.
MSITRANSFORM_ERROR_CHANGECODEPAGE
0x0020
 Halaman transformasi dan kode database tidak cocok dan tidak memiliki halaman kode netral.
MSITRANSFORM_ERROR_VIEWTRANSFORM
0x0100
 Buat tabel _TransformView sementara.

Nilai kembali

Fungsi MsiDatabaseApplyTransform mengembalikan salah satu nilai berikut:

Keterangan

Fungsi MsiDatabaseApplyTransform menunda transformasi tabel hingga diperlukan. Setiap tabel yang akan ditambahkan atau dihilangkan segera diproses. Namun, perubahan pada tabel yang ada tertunda hingga tabel dimuat atau database diterapkan.

Kesalahan terjadi jika MsiDatabaseApplyTransform dipanggil ketika tabel telah dimuat dan disimpan ke penyimpanan.

Karena pemisah daftar untuk transformasi, sumber, dan patch adalah titik koma, karakter ini tidak boleh digunakan untuk nama file atau jalur.

Fungsi ini tidak dapat dipanggil dari tindakan kustom. Panggilan ke fungsi ini dari tindakan kustom menyebabkan fungsi gagal.

Jika fungsi gagal, Anda dapat memperoleh informasi kesalahan yang diperluas dengan menggunakan MsiGetLastErrorRecord.

Catatan

Header msiquery.h mendefinisikan MsiDatabaseApplyTransform sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Installer 5.0 di Windows Server 2012, Windows 8, Windows Server 2008 R2 atau Windows 7. Windows Installer 4.0 atau Windows Installer 4.5 di Windows Server 2008 atau Windows Vista. Windows Installer pada Windows Server 2003 atau Windows XP
Target Platform Windows
Header msiquery.h
Pustaka Msi.lib
DLL Msi.dll

Lihat juga

Fungsi Manajemen Database

Transformasi Database