Fungsi MsiGetMode (msiquery.h)

Artikel
03/15/2023

Fungsi MsiGetMode digunakan untuk menentukan apakah alat penginstal saat ini berjalan dalam mode tertentu, seperti yang tercantum dalam tabel. Fungsi mengembalikan nilai Boolean TRUE atau FALSE, yang menunjukkan apakah properti tertentu yang diteruskan ke fungsi saat ini diatur (TRUE) atau tidak diatur (FALSE).

Sintaks

BOOL MsiGetMode(
  [in] MSIHANDLE  hInstall,
  [in] MSIRUNMODE eRunMode
);

Parameter

[in] hInstall

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

[in] eRunMode

Menentukan mode eksekusi. Parameter ini harus memiliki salah satu nilai berikut.

Nilai	Makna
MSIRUNMODE_ADMIN	Mode administratif sedang menginstal, atau produk sedang diinstal.
MSIRUNMODE_ADVERTISE	Iklan sedang diinstal atau produk sedang menginstal atau memperbarui.
MSIRUNMODE_MAINTENANCE	Penginstalan yang ada sedang dimodifikasi atau ada penginstalan baru.
MSIRUNMODE_ROLLBACKENABLED	Pembatalan diaktifkan.
MSIRUNMODE_LOGENABLED	File log aktif. Ini diaktifkan sebelum sesi penginstalan.
MSIRUNMODE_OPERATIONS	Operasi eksekusi berada dalam fase penentuan.
MSIRUNMODE_REBOOTATEND	Reboot diperlukan setelah penginstalan berhasil (dapat diatur).
MSIRUNMODE_REBOOTNOW	Boot ulang diperlukan untuk melanjutkan penginstalan (dapat diatur).
MSIRUNMODE_CABINET	File dari lemari dan file tabel Media sedang diinstal.
MSIRUNMODE_SOURCESHORTNAMES	LongFileNames sumber ditekan melalui properti ringkasan PID_MSISOURCE.
MSIRUNMODE_TARGETSHORTNAMES	LongFileNames target ditekan melalui properti SHORTFILENAMES .
MSIRUNMODE_RESERVED11	Disiapkan untuk penggunaan masa mendatang.
MSIRUNMODE_WINDOWS9X	Sistem operasi adalah versi 9x.
MSIRUNMODE_ZAWENABLED	Sistem operasi mendukung penginstalan permintaan.
MSIRUNMODE_RESERVED14	Disiapkan untuk penggunaan masa mendatang.
MSIRUNMODE_RESERVED15	Disiapkan untuk penggunaan masa mendatang.
MSIRUNMODE_SCHEDULED	Tindakan kustom yang dipanggil dari eksekusi skrip penginstalan.
MSIRUNMODE_ROLLBACK	Tindakan kustom yang dipanggil dari skrip eksekusi putar kembali.
MSIRUNMODE_COMMIT	Tindakan kustom yang dipanggil dari skrip eksekusi penerapan.

Nilai kembali

TRUE menunjukkan properti tertentu yang diteruskan ke fungsi saat ini diatur.

FALSE menunjukkan properti tertentu yang diteruskan ke fungsi saat ini tidak diatur.

Keterangan

Perhatikan bahwa tidak semua nilai mode eksekusi iRunMode tersedia saat memanggil MsiGetMode dari tindakan kustom yang ditangguhkan. Untuk detailnya, lihat Mendapatkan Informasi Konteks untuk Tindakan Kustom Eksekusi yang Ditangguhkan.

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

Lihat juga

Fungsi Akses Status Alat Penginstal

Bagikan melalui