Fungsi MsiConfigureProductA (msi.h)

  • Artikel

Fungsi MsiConfigureProduct menginstal atau menghapus instalasi produk.

Sintaks

UINT MsiConfigureProductA(
  [in] LPCSTR       szProduct,
  [in] int          iInstallLevel,
  [in] INSTALLSTATE eInstallState
);

Parameter

[in] szProduct

Menentukan kode produk untuk produk yang akan dikonfigurasi.

[in] iInstallLevel

Menentukan berapa banyak produk yang harus diinstal saat menginstal produk ke status defaultnya. Parameter iInstallLevel diabaikan, dan semua fitur diinstal, jika parameter eInstallState diatur ke nilai lain selain INSTALLSTATE_DEFAULT.

Parameter ini bisa menjadi salah satu nilai berikut.

Nilai Makna
INSTALLLEVEL_DEFAULT
 Fitur default yang ditulis diinstal.
INSTALLLEVEL_MINIMUM
 Hanya fitur yang diperlukan yang diinstal. Anda dapat menentukan nilai antara INSTALLLEVEL_MINIMUM dan INSTALLLEVEL_MAXIMUM untuk menginstal subset fitur yang tersedia.
INSTALLLEVEL_MAXIMUM
 Semua fitur diinstal. Anda dapat menentukan nilai antara INSTALLLEVEL_MINIMUM dan INSTALLLEVEL_MAXIMUM untuk menginstal subset fitur yang tersedia.

[in] eInstallState

Menentukan status penginstalan untuk produk. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai Makna
INSTALLSTATE_LOCAL
 Produk ini akan diinstal dengan semua fitur yang diinstal secara lokal.
INSTALLSTATE_ABSENT
 Produk dihapus instalannya.
INSTALLSTATE_SOURCE
 Produk ini akan diinstal dengan semua fitur yang diinstal untuk dijalankan dari sumber.
INSTALLSTATE_DEFAULT
 Produk ini akan diinstal dengan semua fitur yang diinstal ke status default yang ditentukan dalam Tabel Fitur.
INSTALLSTATE_ADVERTISED
 Produk ini diiklankan.

Mengembalikan nilai

Nilai Makna
ERROR_INVALID_PARAMETER
 Parameter yang tidak valid diteruskan ke fungsi.
ERROR_SUCCESS
 Fungsi berhasil.
Kesalahan yang berkaitan dengan tindakan
 Untuk informasi selengkapnya, lihat Kode Kesalahan.
Kesalahan Inisialisasi
 Kesalahan yang berkaitan dengan inisialisasi.

Keterangan

Fungsi MsiConfigureProduct menampilkan antarmuka pengguna (UI) menggunakan pengaturan saat ini. Pengaturan antarmuka pengguna dapat diubah dengan menggunakan MsiSetInternalUI, MsiSetExternalUI atau MsiSetExternalUIRecord.

Parameter iInstallLevel diabaikan, dan semua fitur produk diinstal, jika parameter eInstallState diatur ke nilai lain selain INSTALLSTATE_DEFAULT. Untuk mengontrol penginstalan fitur individual saat parameter eInstallState tidak diatur ke INSTALLSTATE_DEFAULT, gunakan MsiConfigureFeature.

Catatan

Header msi.h mendefinisikan MsiConfigureProduct sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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

Persyaratan 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 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

Penginstalan Beberapa Paket