Bagikan melalui


Fungsi MsiGetMode (msiquery.h)

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