Fungsi MsiConfigureProductA (msi.h)

Artikel
11/20/2024

Fungsi MsiConfigureProduct menginstal atau menghapus instalan produk.

Sintaksis

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	Arti
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	Arti
INSTALLSTATE_LOCAL	Produk ini akan diinstal dengan semua fitur yang diinstal secara lokal.
INSTALLSTATE_ABSENT	Produk dihapus instalasinya.
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	Arti
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.

Komentar

Fungsi MsiConfigureProduct menampilkan antarmuka pengguna (UI) menggunakan pengaturan saat ini. Pengaturan antarmuka pengguna dapat diubah dengan menggunakanMsiSetInternalUI , 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.

Nota

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

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 Multiple-Package

Bagikan melalui