Objek sesi (Pemasang Windows)

Objek Sesi mengontrol proses penginstalan. Ini membuka database Penginstal, yang berisi tabel dan data penginstalan. Objek ini dikaitkan dengan serangkaian fungsi tindakan standar, masing-masing melakukan operasi tertentu pada data dari satu atau beberapa tabel. Tindakan kustom tambahan dapat ditambahkan untuk penginstalan produk tertentu. Fungsi mesin dasar adalah pengurut yang mengambil rekaman berurutan dari tabel urutan yang ditunjuk, mengevaluasi ekspresi kondisi tertentu, dan menjalankan tindakan yang ditunjuk. Tindakan yang tidak dikenali oleh mesin ditangguhkan ke objek handler UI untuk diproses, biasanya urutan kotak dialog.

Perhatikan bahwa hanya satu objek Sesi yang dapat dibuka dengan satu proses.

Anggota

Objek Sesi memiliki jenis anggota ini:

Metode

Objek Sesi memiliki metode ini.

Metode Deskripsi
DoAction Menjalankan tindakan yang ditentukan.
EvaluateCondition Mengevaluasi ekspresi logis yang berisi simbol dan nilai dan mengembalikan bilangan bulat msiEvaluateConditionErrorEnum enumerasi.
FeatureInfo Mengembalikan objek FeatureInfo yang berisi informasi deskriptif untuk fitur yang ditentukan.
FormatRecord Mengembalikan string yang diformat dari templat dan data rekaman.
Pesan Melakukan operasi pengelogan yang diaktifkan dan menunda eksekusi ke objek handler UI yang terkait dengan mesin.
Urutan Membuka kueri pada tabel yang ditentukan, mengurutkan tindakan menurut angka di kolom Urutan. Untuk setiap baris yang diambil, metode DoAction dipanggil, asalkan ekspresi kondisi yang disediakan tidak mengevaluasi ke False.
SetInstallLevel Mengatur tingkat penginstalan untuk penginstalan saat ini ke nilai tertentu dan menghitung ulang status Pilih dan Terinstal untuk semua fitur.

 

Properti

Objek Sesi memiliki properti ini.

Properti Jenis akses Deskripsi
ComponentCosts
Mengembalikan objek RecordList yang menghitung ruang disk per drive yang diperlukan untuk menginstal komponen.
ComponentCurrentState
Mengembalikan status terinstal saat ini dari komponen yang ditunjuk.
ComponentRequestState
Mendapatkan atau meminta perubahan dalam status Tindakan baris dalam tabel Komponen.
Database
Mengembalikan database untuk sesi penginstalan saat ini.
FeatureCost
Mengembalikan jumlah total ruang disk (dalam satuan 512 byte) yang diperlukan oleh fitur yang ditentukan dan fitur induknya (hingga akar tabel Fitur).
FeatureCurrentState
Mengembalikan status terinstal saat ini dari fitur yang ditunjuk.
FeatureRequestState
Baca/Tulis
Mendapatkan atau meminta perubahan dalam status Pilih rekaman dan subrekor fitur.
FeatureValidStates
Mengembalikan bilangan bulat yang mewakili bendera bit dengan setiap bit yang relevan yang mewakili status penginstalan yang valid untuk fitur yang ditentukan.
Installer
Mengembalikan objek alat penginstal aktif.
Bahasa (Objek Sesi)
Mewakili pengidentifikasi bahasa numerik yang digunakan oleh sesi penginstalan saat ini.
Mode
Properti ini adalah nilai yang mewakili bendera mode yang ditunjuk untuk sesi penginstalan saat ini.
ProductProperty
Mewakili nilai string properti alat penginstal bernama.
Properti (Objek Sesi)
Baca/Tulis
Mengambil properti produk dari database produk.
SourcePath
Menyediakan jalur lengkap ke folder yang ditunjuk pada media sumber atau gambar server.
TargetPath
Baca/Tulis
Menyediakan jalur lengkap ke folder yang ditunjuk pada drive target penginstalan.
VerifyDiskSpace
Mengembalikan true jika ada cukup ruang disk, dan false jika disk penuh.

 

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_ISession didefinisikan sebagai 000C109E-0000-0000-C000-000000000046

Lihat juga

Contoh Pembuatan Skrip Penginstal Windows