Bagikan melalui


Metode Installer.ProvideComponent

Metode ProvideComponent dari objek Alat Penginstal mengembalikan jalur komponen lengkap dan melakukan penginstalan yang diperlukan. Jika perlu, metode ProvideComponent dari objek Penginstal meminta sumber dan menaikkan jumlah penggunaan untuk fitur tersebut.

Sintaks

Installer.ProvideComponent(
  Product,
  Feature,
  Component,
  InstallMode
)

Parameter

Produk

Menentukan kode produk produk.

Fitur

Menentukan ID fitur dari fitur yang berisi komponen.

Komponen

Menentukan kode komponen.

InstallMode

Menentukan mode penginstalan. Parameter ini bisa menjadi salah satu nilai yang diperlihatkan dalam tabel berikut.

Nama Makna
msiInstallModeDefault
0
Menyediakan jalur komponen, melakukan penginstalan apa pun, jika perlu.
msiInstallModeExisting
–1
Menyediakan jalur komponen hanya jika fitur ada; jika tidak, mengembalikan string kosong. Mode ini memverifikasi keberadaan file kunci komponen.
msiInstallModeNoDetection
–2
Menyediakan jalur komponen hanya jika fitur ada. Jika tidak, mengembalikan string kosong. Mode ini memeriksa pendaftaran komponen tetapi tidak memverifikasi keberadaan file kunci komponen.
msiInstallModeNoSourceResolution
–3
Menyediakan jalur komponen hanya jika fitur ada dengan parameter InstallState msiInstallStateLocal. Ini memeriksa pendaftaran komponen tetapi tidak memverifikasi keberadaan file kunci komponen.
kombinasi bendera msiReinstallMode
Memanggil ReinstallFeature untuk menginstal ulang fitur menggunakan parameter ini untuk parameter ReinstallMode , lalu menyediakan komponen.

 

Nilai kembali

Metode ini tidak mengembalikan nilai.

Keterangan

Metode ProvideComponent menggabungkan fungsionalitas UseFeature, ConfigureFeature, dan ComponentPath. Metode ProvideComponent menyederhanakan urutan panggilan, tetapi juga meningkatkan jumlah penggunaan dan harus digunakan dengan hati-hati untuk mencegah jumlah penggunaan yang tidak akurat. Metode ProvideComponent juga memberikan lebih sedikit fleksibilitas daripada serangkaian panggilan individual ke metode dan properti yang disebutkan sebelumnya.

Jika aplikasi pulih dari situasi yang tidak terduga, aplikasi mungkin sudah disebut UseFeature dan meningkatkan jumlah penggunaan. Dalam hal ini, aplikasi harus menghindari peningkatan jumlah penggunaan dengan memanggil metode ConfigureFeature alih-alih metode ProvideComponent .

Opsi msiInstallModeExisting tidak dapat digunakan dalam kombinasi dengan bendera msiReinstallMode.

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

Lihat juga

MsiProvideComponent