Fungsi MsiReinstallFeatureA (msi.h)

Artikel
03/15/2023

Fungsi MsiReinstallFeature menginstal ulang fitur.

Sintaks

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 turunan, Anda harus memanggil fungsi MsiReinstallFeature untuk masing-masing secara terpisah atau menggunakan fungsi MsiReinstallProduct .

[in] dwReinstallMode

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

Nilai	Makna
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 dari Tabel Kelas, Tabel Kata Kerja, Tabel PublishComponent, Tabel ProgID, Tabel MIME, Tabel Ikon, Tabel Ekstensi, dan Tabel AppID terlepas dari penugasan mesin atau pengguna. Instal ulang semua komponen yang 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.

Nilai kembali

Menampilkan 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.

Keterangan

Catatan

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


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 di 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.
Target Platform	Windows
Header	msi.h
Pustaka	Msi.lib
DLL	Msi.dll

Lihat juga

Fungsi Penginstalan dan Konfigurasi

Penginstalan Beberapa Paket

INSTAL ULANG PropertiMODE

Bagikan melalui