Fungsi MsiSetInstallLevel (msiquery.h)

Fungsi MsiSetInstallLevel mengatur tingkat penginstalan untuk penginstalan produk lengkap.

Sintaks

UINT MsiSetInstallLevel(
  [in] MSIHANDLE hInstall,
  [in] int       iInstallLevel
);

Parameter

[in] hInstall

Tangani penginstalan yang disediakan untuk tindakan kustom DLL atau diperoleh dengan menggunakan MsiOpenPackage, MsiOpenPackageEx, atau MsiOpenProduct.

[in] iInstallLevel

Tingkat penginstalan.

Nilai kembali

Fungsi MsiSetInstallLevel mengembalikan salah satu nilai berikut:

Keterangan

Fungsi MsiSetInstallLevel mengatur hal berikut:

  • Tingkat penginstalan untuk penginstalan saat ini ke nilai yang ditentukan.
  • Status Pilih dan Terinstal untuk semua fitur dalam tabel Fitur.
  • Status Tindakan dari setiap komponen dalam tabel Komponen, berdasarkan tingkat baru.
Untuk penginstalan apa pun, ada tingkat penginstalan yang ditentukan, yang merupakan nilai integral dari 1 hingga 32.767. Nilai awal ditentukan oleh properti INSTALLLEVEL , yang diatur dalam Tabel Properti.

Jika 0 (nol) atau angka negatif diteruskan dalam parameter iInstallLevel , tingkat penginstalan saat ini tidak berubah, tetapi semua fitur masih diperbarui berdasarkan tingkat penginstalan saat ini. Untuk informasi selengkapnya, lihat Memanggil Fungsi Database Dari Program.

Jika fungsi gagal, Anda dapat memperoleh informasi kesalahan yang diperluas dengan menggunakan MsiGetLastErrorRecord.

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. Pemasang Windows pada Windows Server 2003 atau Windows XP
Target Platform Windows
Header msiquery.h
Pustaka Msi.lib
DLL Msi.dll

Lihat juga

Fungsi Pemilihan Alat Penginstal