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 |
|
| IID |
IID_ISession didefinisikan sebagai 000C109E-0000-0000-C000-000000000046 |
Lihat juga