Metode Session.Message

  • Artikel

Metode Pesan objek Sesi melakukan operasi pengelogan yang diaktifkan dan menunda eksekusi ke objek handler UI yang terkait dengan mesin. Pengelogan dapat diaktifkan secara selektif untuk berbagai jenis pesan. Lihat metode EnableLog.

Jika bidang rekaman 0 berisi string pemformatan, bidang tersebut digunakan untuk memformat data di bidang lain. Jika tidak, jika pesan adalah pesan kesalahan, peringatan, atau pengguna, upaya dilakukan untuk menemukan templat pesan di tabel Kesalahan untuk database saat ini menggunakan nomor kesalahan yang ditemukan di bidang 1 rekaman untuk jenis pesan dan mengembalikan nilai.

Sintaks

Session.Message(
  kind,
  record
)

Parameter

jenis

Parameter jenis diperlukan untuk menjadi salah satu nilai berikut. Untuk menampilkan kotak pesan dengan tombol dan ikon push, hitung nilai jenis dengan menambahkan gaya kotak pesan standar yang digunakan oleh MessageBox dan MessageBoxEx ke msiMessageTypeError, msiMessageTypeWarning, atau msiMessageTypeUser. Untuk informasi selengkapnya, lihat bagian Keterangan di bawah ini.

Terus-menerus Makna
msiMessageTypeFatalExit
&H00000000
 Penghentian dini, mungkin fatal kehabisan memori.
msiMessageTypeError
&H01000000
 Pesan kesalahan yang diformat, [1] adalah nomor pesan dalam tabel Kesalahan.
msiMessageTypeWarning
&H02000000
 Pesan peringatan yang diformat, [1] adalah nomor pesan dalam tabel Kesalahan.
msiMessageTypeUser
&H03000000
 Pesan permintaan pengguna, [1] adalah nomor pesan dalam tabel Kesalahan.
msiMessageTypeInfo
&H04000000
 Pesan informatif untuk log, tidak ditampilkan.
msiMessageTypeFilesInUse
&H05000000
 Daftar file yang digunakan yang perlu diganti.
msiMessageTypeResolveSource
&H06000000
 Permintaan untuk menentukan lokasi sumber yang valid.
msiMessageTypeOutOfDiskSpace
&H07000000
 Pesan ruang disk tidak cukup.
msiMessageTypeActionStart
&H08000000
 Mulai tindakan, [1] nama tindakan, [2] deskripsi, [3] templat untuk pesan ACTIONDATA.
msiMessageTypeActionData
&H09000000
 Data tindakan. Bidang rekaman sesuai dengan templat pesan ACTIONSTART.
msiMessageTypeProgress
&H0A000000
 Informasi bilah kemajuan. Lihat deskripsi bidang rekaman di bawah ini.
msiMessageTypeCommonData
&H0B000000
 Untuk mengaktifkan tombol Batalkan, atur [1] ke 2 dan [2] ke 1.
Untuk menonaktifkan tombol Batalkan, atur [1] ke 2 dan [2] ke 0

 

record

Objek Rekaman yang diperlukan berisi bidang khusus pesan.

Nilai hasil

Terus-menerus Value
msiMessageStatusError
 -1
msiMessageStatusNone
 0
msiMessageStatusOk
 1
msiMessageStatusCancel
 2
msiMessageStatusAbort
 3
msiMessageStatusRetry
 4
msiMessageStatusIgnore
 5
msiMessageStatusYes
 6
msiMessageStatusNo
 7

 

Keterangan

Bidang Rekaman Pesan

Berikut ini menjelaskan definisi bidang rekaman saat msiMessageTypeProgress diteruskan sebagai jenis pesan.

Bidang 1 menentukan jenis pesan kemajuan. Arti bidang lain bergantung pada nilai di bidang ini. Nilai yang mungkin dapat diatur ke dalam Bidang 1 adalah sebagai berikut.

Nama pesan Value Deskripsi Bidang 1
MasterReset 0 Mereset bilah kemajuan dan mengatur jumlah total tick yang diharapkan di bilah.
ActionInfo 1 Menyediakan informasi yang terkait dengan pesan kemajuan yang akan dikirim oleh tindakan saat ini.
ProgressReport 2 Menaikkan bilah kemajuan.
ProgressAddition 3 Memungkinkan tindakan (seperti CustomAction) untuk menambahkan tanda centang ke jumlah total kemajuan bilah kemajuan yang diharapkan.

 

Arti Bidang 2 tergantung pada nilai di Bidang 1 sebagai berikut.

Nilai Bidang 1 Deskripsi Bidang 2
0 Jumlah total tick yang diharapkan di bilah kemajuan.
1 Jumlah tanda centang yang dipindahkan bilah kemajuan untuk setiap pesan ActionData. Bidang ini diabaikan jika Bidang 3 adalah 0.
2 Jumlah tanda centang yang telah dipindahkan bilah kemajuan.
3 Jumlah tanda centang untuk ditambahkan ke total kemajuan yang diharapkan.

 

Arti Bidang 3 tergantung pada nilai di Bidang 1 sebagai berikut.

Nilai Bidang 1 Nilai Bidang 3 Deskripsi Bidang 3
0 0 Teruskan bilah kemajuan (kiri ke kanan)
  1 Bilah kemajuan mundur (kanan ke kiri)
1 0 Tindakan saat ini akan mengirim pesan ProgressReport eksplisit.
  1 Tingkatkan bilah kemajuan dengan jumlah tanda centang yang ditentukan di Bidang 2 setiap kali pesan ActionData dikirim.
2 Tidak digunakan
3 Tidak digunakan

 

Arti Bidang 4 tergantung pada nilai di Bidang 1 sebagai berikut.

Nilai Bidang 1 Nilai Bidang 4 Deskripsi Bidang 4
0 0 Eksekusi sedang berlangsung. Dalam hal ini, UI dapat menghitung dan menampilkan sisa waktu.
  1 Membuat skrip eksekusi. Dalam hal ini, UI dapat menampilkan pesan untuk menunggu sementara alat penginstal selesai menyiapkan penginstalan.
1 Tidak digunakan
2 Tidak digunakan
3 Tidak digunakan

 

Menampilkan Kotak Pesan

Untuk menampilkan kotak pesan dengan tombol dan ikon push, hitung nilai jenis dengan menambahkan gaya kotak pesan standar yang digunakan oleh MessageBox dan MessageBoxEx ke msiMessageTypeError, msiMessageTypeWarning, atau msiTypeUser. Opsi tombol push yang tersedia untuk VBScript adalah vbOKOnly (MB_OK), vbOKCancel (MB_OKCANCEL), vbAbortRetryIgnore (MB_ABORTRETRYIGNORE), vbYesNoCancel (MB_YESNOCANCEL), vbYesNo (MB_YESNO), dan vbRetryCancel (MB_RETRYCANCEL). Opsi ikon yang tersedia untuk VBScript adalah vbCritical (MB_ICONERROR), vbQuestion (MB_ICONQUESTION), vbExclamation (MB_ICONWARNING), dan vbInformation (MB_ICONINFORMATION).

Misalnya, panggilan berikut mengirimkan pesan msiMessageTypeError dengan ikon vbExclamation dan tombol vbYesNo.

Session.Message &H01000034, record

Jika tindakan kustom memanggil metode Pesan , tindakan kustom harus mampu menangani pembatalan oleh pengguna dan harus mengembalikan msiDoActionStatusUserExit.

Persyaratan

Persyaratan Value
Versi
 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. Windows Installer pada Windows Server 2003 atau Windows XP
DLL
Msi.dll
IID
 IID_ISession didefinisikan sebagai 000C109E-0000-0000-C000-000000000046