Bagikan melalui

Fungsi MsiReinstallFeatureA (msi.h)

  • Artikel

Fungsi MsiReinstallFeature menginstal ulang fitur.

Sintaksis

UINT MsiReinstallFeatureA(
  [in] LPCSTR szProduct,
  [in] LPCSTR szFeature,
  [in] DWORD  dwReinstallMode
);

Parameter

[in] szProduct

Menentukan kode produk untuk produk yang berisi fitur yang akan diinstal ulang.

[in] szFeature

Menentukan fitur yang akan diinstal ulang. Fitur induk atau fitur turunan dari fitur yang ditentukan tidak diinstal ulang. Untuk menginstal ulang fitur induk atau anak, Anda harus memanggil fungsi MsiReinstallFeature untuk masing-masing secara terpisah atau menggunakan fungsi MsiReinstallProduct.

[in] dwReinstallMode

Menentukan apa yang harus diinstal. Parameter ini bisa berupa satu atau beberapa nilai berikut.

Nilai Arti
REINSTALLMODE_FILEMISSING
 Instal ulang hanya jika file hilang.
REINSTALLMODE_FILEOLDERVERSION
 Instal ulang jika file hilang atau merupakan versi yang lebih lama.
REINSTALLMODE_FILEEQUALVERSION
 Instal ulang jika file hilang, atau merupakan versi yang sama atau lebih lama.
REINSTALLMODE_FILEEXACT
 Instal ulang jika file hilang atau merupakan versi yang berbeda.
REINSTALLMODE_FILEVERIFY
 Verifikasi nilai checksum, dan instal ulang file jika hilang atau rusak. Bendera ini hanya memperbaiki file yang memiliki msidbFileAttributesChecksum di kolom Atribut tabel File .
REINSTALLMODE_FILEREPLACE
 Paksa semua file untuk diinstal ulang, terlepas dari checksum atau versi.
REINSTALLMODE_USERDATA
 Tulis ulang semua entri registri yang diperlukan dari Tabel Registri yang masuk ke HKEY_CURRENT_USER

atau HKEY_USERS

sarang registri.
REINSTALLMODE_MACHINEDATA
 Tulis ulang semua entri registri yang diperlukan dari Tabel Registri yang masuk ke HKEY_LOCAL_MACHINE

atau HKEY_CLASSES_ROOT

sarang registri. Tulis ulang semua informasi dariTabel Kelas , Tabel Kata Kerja, PublishComponent Table, ProgID Table, Tabel MIME , tabel ikon , tabel ekstensi , dan Tabel AppID terlepas dari penugasan mesin atau pengguna. Instal ulang semua komponen memenuhi syarat.

Saat menginstal ulang aplikasi, opsi ini menjalankan tindakan RegisterTypeLibraries dan InstallODBC.
REINSTALLMODE_SHORTCUT
 Instal ulang semua pintasan dan cache ulang semua ikon yang menimpa pintasan dan ikon yang ada.
REINSTALLMODE_PACKAGE
 Gunakan untuk menjalankan dari paket sumber dan cache ulang paket lokal. Jangan gunakan untuk penginstalan pertama aplikasi atau fitur.

Mengembalikan nilai

Mengembalikan kode Deskripsi
ERROR_INSTALL_FAILURE
 Penginstalan gagal.
ERROR_INVALID_PARAMETER
 Parameter yang tidak valid diteruskan ke fungsi.
ERROR_INSTALL_SERVICE_FAILURE
 Layanan penginstalan tidak dapat diakses.
ERROR_INSTALL_SUSPEND
 Penginstalan ditangguhkan dan tidak lengkap.
ERROR_INSTALL_USEREXIT
 Pengguna membatalkan penginstalan.
ERROR_SUCCESS
 Fungsi berhasil diselesaikan.
ERROR_UNKNOWN_FEATURE
 ID fitur tidak mengidentifikasi fitur yang diketahui.
ERROR_UNKNOWN_PRODUCT
 Kode produk tidak mengidentifikasi produk yang diketahui.
 

Untuk informasi selengkapnya, lihat Pesan Kesalahan yang Ditampilkan.

Komentar

Nota

Header msi.h mendefinisikan MsiReinstallFeature sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat Nilai
klien minimum yang didukung 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 pada Windows Server 2008 atau Windows Vista. Windows Installer pada Windows Server 2003 atau Windows XP. Lihat Persyaratan Run-Time Penginstal Windows untuk informasi tentang paket layanan Windows minimum yang diperlukan oleh versi Penginstal Windows.
Platform Target Windows
Header msi.h
Pustaka Msi.lib
DLL Msi.dll

Lihat juga

Penginstalan dan Konfigurasi

Penginstalan Multiple-Package

Properti REINSTALLMODE