Objek penginstal

Objek Penginstal awalnya harus dibuat untuk memuat dukungan otomatisasi yang diperlukan COM untuk mengakses fungsi alat penginstal. Objek ini menyediakan pembungkus untuk membuat objek tingkat atas dan mengakses metodenya.

Anda dapat membuat objek Alat Penginstal dari ProgId "WindowsInstaller.Installer".

Anggota

Objek Penginstal memiliki jenis anggota ini:

Metode

Objek Penginstal memiliki metode ini.

Metode Deskripsi
AddSource Menambahkan sumber ke daftar sumber jaringan yang valid dalam daftar sumber.
AdvertiseProduct Mengiklankan paket penginstalan.
AdvertiseScript Mengiklankan paket penginstalan.
ApplyMultiplePatches Menerapkan satu atau beberapa patch ke produk yang memenuhi syarat untuk menerima patch. Mengatur properti PATCH ke jalur paket patch yang disediakan.
ApplyPatch Memanggil penginstalan dan mengatur properti PATCH ke jalur paket patch untuk setiap produk yang tercantum oleh paket patch sebagai memenuhi syarat untuk menerima patch.
ClearSourceList Menghapus semua sumber jaringan dari daftar sumber.
CollectUserInfo Memanggil urutan wizard antarmuka pengguna yang mengumpulkan dan menyimpan informasi pengguna dan kode produk.
MengonfigurasiFeature Mengonfigurasi status terinstal fitur produk.
MengonfigurasiProduct Menginstal atau menghapus instalasi produk.
CreateAdvertiseScript Menghasilkan skrip iklan.
CreateRecord Mengembalikan objek Rekaman baru dengan jumlah bidang yang diminta.
AktifkanLog Mengaktifkan pengelogan tipe pesan yang dipilih untuk semua sesi penginstalan berikutnya di ruang proses saat ini.
ExtractPatchXMLData Mengekstrak informasi dari patch sebagai string XML.
FileHash Mengambil jalur ke file dan mengembalikan hash 128-bit dari file tersebut.
FileSignatureInfo Mengambil jalur ke file dan mengembalikan SAFEARRAY byte yang mewakili hash atau sertifikat yang dikodekan.
Filesize Mengembalikan ukuran file yang ditentukan.
FileVersion Mengembalikan string versi atau string bahasa dari jalur yang ditentukan.
ForceSourceListResolution Memaksa alat penginstal untuk mencari daftar sumber untuk sumber produk yang valid saat sumber diperlukan di lain waktu.
InstallProduct Membuka paket alat penginstal dan menginisialisasi sesi penginstalan.
LastErrorRecord Mengembalikan objek Rekaman yang berisi parameter kesalahan untuk kesalahan terbaru dari fungsi yang menghasilkan rekaman kesalahan.
OpenDatabase Membuka database yang sudah ada atau membuat database baru.
OpenPackage Membuka paket alat penginstal untuk digunakan dengan fungsi yang mengakses database produk dan menginstal mesin.
OpenProduct Membuka paket alat penginstal untuk produk yang diinstal menggunakan kode produk.
ProvideAssembly Mengembalikan jalur rakitan yang diinstal.
ProvideComponent Mengembalikan jalur komponen lengkap dan melakukan penginstalan yang diperlukan.
ProvideQualifiedComponent Mengembalikan jalur komponen lengkap dan melakukan penginstalan yang diperlukan.
RegistryValue Membaca informasi tentang kunci nilai registri tertentu.
Instal ulangFeature Menginstal ulang fitur atau memperbaiki masalah dengan fitur yang diinstal.
Instal ulangProduct Menginstal ulang produk atau memperbaiki masalah penginstalan dalam produk yang diinstal.
RemovePatches Menghapus satu atau beberapa patch ke produk yang memenuhi syarat untuk menerima patch.
UseFeature Menaikkan jumlah penggunaan untuk fitur tertentu dan mengembalikan status penginstalan untuk fitur tersebut.

 

Properti

Objek Penginstal memiliki properti ini.

Properti Jenis akses Deskripsi
ClientsEx
Mengembalikan objek RecordList yang mencantumkan produk yang menggunakan komponen terinstal tertentu.
Windows Installer 4.5 dan yang lebih lama: Tidak didukung.
ComponentClients
Mengembalikan objek StringList yang menghitung kumpulan klien dari komponen tertentu.
ComponentPath
Mengembalikan jalur lengkap ke komponen yang diinstal.
ComponentPathEx
Mengembalikan objek RecordList yang memberikan jalur lengkap komponen yang diinstal tertentu.
Windows Installer 4.5 dan yang lebih lama: Tidak didukung.
ComponentQualifiers
Mengembalikan objek StringList yang menghitung kumpulan kualifikasi terdaftar untuk komponen yang ditentukan.
Komponen
Mengembalikan objek StringList yang menghitung kumpulan komponen yang diinstal untuk semua produk.
ComponentsEx
Mengembalikan objek RecordList yang mencantumkan komponen terinstal.
Windows Installer 4.5 dan yang lebih lama: Tidak didukung.
Lingkungan
Baca/Tulis
Nilai string untuk variabel lingkungan dari proses saat ini.
FeatureParent
Menentukan fitur induk fitur.
Fitur
Mengembalikan objek StringList yang menghitung kumpulan fitur yang diterbitkan untuk produk yang ditentukan.
FeatureState
Mengembalikan status fitur yang terinstal.
FeatureUsageCount
Mengembalikan berapa kali fitur telah digunakan.
FeatureUsageDate
Mengembalikan tanggal terakhir kali fitur yang ditentukan digunakan.
FileAttributes
Mengembalikan angka yang mewakili atribut file gabungan untuk jalur yang ditunjuk ke file atau folder.
Patch
Mengembalikan objek StringList yang berisi semua patch yang diterapkan ke produk.
PatchsEx
Menghitung kumpulan objek Patch .
PatchFiles
Mengembalikan objek StringList yang berisi daftar file yang dapat diperbarui oleh daftar patch yang disediakan.
PatchInfo
Mengembalikan informasi tentang patch.
PatchTransforms
Mengembalikan daftar transformasi yang dibatasi titik koma yang ada dalam paket patch yang ditentukan dan diterapkan ke produk yang ditentukan.
ProductElevated
Mengembalikan True jika produk dikelola atau False jika produk tidak dikelola.
ProductInfo
Mengembalikan nilai atribut yang ditentukan untuk produk yang diinstal atau diterbitkan.
ProductInfoFromScript
Mengembalikan nilai atribut yang ditentukan yang disimpan dalam skrip iklan.
Produk
Mengembalikan objek StringList yang menghitung kumpulan semua produk yang diinstal atau diiklankan untuk pengguna dan mesin saat ini.
ProductsEx
Menghitung kumpulan objek Produk .
ProductState
Mengembalikan informasi status penginstalan untuk produk.
QualifierDescription
Mengembalikan string teks yang menjelaskan komponen yang memenuhi syarat.
RelatedProducts
Mengembalikan objek StringList yang menghitung kumpulan semua produk yang diinstal atau diiklankan untuk pengguna dan mesin saat ini dengan properti UpgradeCode tertentu dalam tabel properti mereka.
PintasanTarget
Memeriksa pintasan dan mengembalikan produk, nama fitur, dan komponennya jika tersedia.
RingkasanInformasi
Mengembalikan objek SummaryInfo yang dapat digunakan untuk memeriksa, memperbarui, dan menambahkan properti ke aliran informasi ringkasan paket atau transformasi.
UILevel
Baca/Tulis
Menunjukkan jenis antarmuka pengguna yang akan digunakan saat membuka dan memproses paket berikutnya dalam ruang proses saat ini.
Versi
Mengembalikan representasi string dari versi Pemasang Windows saat ini.

 

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

Lihat juga

Menggunakan Antarmuka Automation

Contoh Skrip Penginstal Windows