Fungsi MsiConfigureProductExA (msi.h)

Artikel
11/20/2024

Fungsi MsiConfigureProductEx menginstal atau menghapus instalan produk. Baris perintah produk juga dapat ditentukan.

Sintaksis

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

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 apa pun 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.

[in] szCommandLine

Menentukan pengaturan properti baris perintah. Ini harus menjadi daftar format Property=Setting Property=Setting. Untuk informasi selengkapnya, lihat Tentang Properti.

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	Terjadi kesalahan terkait inisialisasi.

Komentar

Baris perintah yang diteruskan sebagai szCommandLine dapat berisi salah satu Properti Opsi Penginstalan Fitur . Dalam hal ini, eInstallState yang diteruskan harus INSTALLSTATE_DEFAULT.

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.

Fungsi MsiConfigureProductEx menampilkan antarmuka pengguna menggunakan pengaturan saat ini. Pengaturan antarmuka pengguna dapat diubah denganMsiSetInternalUI , MsiSetExternalUI, atau MsiSetExternalUIRecord.

Nota

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

Pesan Kesalahan yang Ditampilkan

Kode Kesalahan

Kesalahan Inisialisasi

Penginstalan dan Konfigurasi

Penginstalan Multiple-Package

Bagikan melalui