Mengembalikan Nilai dari Handler Antarmuka Pengguna Eksternal

Handler antarmuka pengguna eksternal (UI) dapat mengembalikan sejumlah nilai ke Penginstal Windows tergantung pada jenis tombol yang disediakan dalam parameter jenis pesan yang diteruskan penginstal ke handler.

Handler UI eksternal dapat mengembalikan nilai -1 dan 0 kapan saja karena ini tidak terkait dengan jenis tombol. Nilai pengembalian –1 menunjukkan bahwa terjadi kesalahan internal di handler UI eksternal. Nilai pengembalian 0 menunjukkan bahwa handler UI eksternal belum menangani pesan penginstal dan alat penginstal harus menangani pesan sebagai gantinya.

Untuk pesan yang tidak menyertakan jenis tombol, seperti INSTALLMESSAGE_ACTIONDATA dan INSTALLMESSAGE_PROGRESS, mengembalikan IDCANCEL membatalkan penginstalan. MENGEMBALIKAN IDOK memberi tahu alat penginstal bahwa pesan ditangani oleh handler UI eksternal.

Nilai pengembalian yang tersisa, seperti yang dijelaskan di bawah ini, terkait langsung dengan jenis tombol yang disertakan dengan jenis pesan.

Nilai pengembalian antarmuka pengguna eksternal	Makna
IDOK	Tombol OK ditekan oleh pengguna. Informasi pesan dipahami.
IDCANCEL	Tombol BATAL ditekan. Batalkan penginstalan.
IDABORT	Tombol ABORT ditekan. Batalkan penginstalan.
IDRETRY	Tombol COBA LAGI ditekan. Coba lagi tindakan tersebut.
IDIGNORE	Tombol IGNORE ditekan. Abaikan kesalahan dan lanjutkan.
IDYES	Tombol YA ditekan. Respons afirmatif, lanjutkan dengan urutan peristiwa saat ini..
IDNO	Tombol TIDAK ditekan. Respons negatif, tidak berlanjut dengan urutan peristiwa saat ini.

 

Misalnya, jika handler UI eksternal dikirimi pesan dengan bendera gaya kotak pesan MB_ABORTRETRYIGNORE, handler UI eksternal dapat mengembalikan salah satu nilai berikut:

• –1 (kesalahan dalam handler UI eksternal)
• 0 (tidak ada tindakan yang diambil dalam handler UI eksternal, biarkan Pemasang Windows menanganinya)
• IDABORT (tombol ABORT ditekan)
• IDRETRY (tombol COBA LAGI ditekan)
• IDIGNORE (tombol IGNORE ditekan)