Metode Installer.OpenDatabase

Metode OpenDatabase objek Alat Penginstal membuka database yang sudah ada atau membuat database baru, mengembalikan objek Database . Ini menghasilkan kesalahan jika objek Database tidak dapat berhasil dibuat dan dibuka.

Sintaks

Installer.OpenDatabase(
  name,
  openMode
)

Parameter

nama

String yang diperlukan yang berisi nama jalur database. Jika string kosong disediakan, database sementara dibuat yang tidak bertahan.

openMode

Parameter dari daftar berikut atau string yang berisi nama jalur file database output baru yang akan ditulis setelah penerapan.

Parameter Makna
msiOpenDatabaseModeReadOnly
0
Membuka database baca-saja, tidak ada perubahan persisten.
msiOpenDatabaseModeTransact
1
Membuka database baca/tulis dalam mode transaksi.
msiOpenDatabaseModeDirect
2
Membuka database langsung baca/tulis tanpa transaksi.
msiOpenDatabaseModeCreate
3
Membuat database baru, mode bertransaksi baca/tulis.
msiOpenDatabaseModeCreateDirect
4
Membuat database baru, mode langsung baca/tulis.
msiOpenDatabaseModeListScript
5
Membuka database untuk melihat file skrip iklan, seperti file yang dihasilkan oleh metode CreateAdvertiseScript .
msiOpenDatabaseModePatchFile
32
Menambahkan bendera ini untuk menunjukkan file patch.

 

Nilai kembali

Objek Database yang mewakili database penginstal yang sudah ada atau baru yang dibuka.

Keterangan

Ketika database dibuka sebagai output database lain, aliran informasi ringkasan database output sebenarnya adalah cermin baca-saja dari database asli dan dengan demikian tidak dapat diubah. Selain itu, database tidak bertahan dengan database. Untuk membuat atau mengubah informasi ringkasan untuk database output, itu harus ditutup dan dibuka kembali.

Untuk membuat dan menyimpan perubahan pada database, pertama-tama buka database dalam transaksi (msiOpenDatabaseModeTransact), buat (msiOpenDatabaseModeCreate atau msiOpenDatabaseModeCreateDirect), atau mode langsung (msiOpenDatabaseModeDirect). Setelah membuat perubahan, selalu panggil metode Penerapan sebelum menutup handel database. Metode Penerapan menghapus semua buffer.

Selalu panggil metode Penerapan pada database yang telah dibuka dalam mode langsung (msiOpenDatabaseModeDirect atau msiOpenDatabaseModeCreateDirect) sebelum menutup database. Kegagalan untuk melakukan ini mungkin merusak database.

Karena metode OpenDatabase memulai akses database, metode tersebut tidak dapat digunakan dengan penginstalan yang sedang berjalan.

Jika metode gagal, Anda dapat memperoleh informasi kesalahan yang diperluas dengan menggunakan metode LastErrorRecord .

Persyaratan

Persyaratan Nilai
Versi
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. Pemasang Windows pada Windows Server 2003 atau Windows XP
DLL
Msi.dll
IID
IID_IInstaller didefinisikan sebagai 000C1090-0000-0000-C000-000000000046