Fungsi MsiGetMode (msiquery.h)

  • Artikel

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