PWLX_MESSAGE_BOX fungsi panggilan balik (winwlx.h)

Artikel
08/28/2023

[Fungsi WlxMessageBox tidak lagi tersedia untuk digunakan pada Windows Server 2008 dan Windows Vista.]

Fungsi WlxMessageBox dipanggil oleh GINA untuk membuat, menampilkan, dan mengoperasikan kotak pesan.

Catatan DLL GINA diabaikan di Windows Vista.

Sintaks

PWLX_MESSAGE_BOX PwlxMessageBox;

int PwlxMessageBox(
  [in] HANDLE hWlx,
  [in] HWND hwndOwner,
  [in] LPWSTR lpszText,
  [in] LPWSTR lpszTitle,
  [in] UINT fuStyle
)
{...}

Parameter

[in] hWlx

Menentukan handel Winlogon yang diteruskan ke GINA dalam panggilan WlxInitialize .

[in] hwndOwner

Menentukan jendela pemilik kotak pesan yang akan dibuat. Jika parameter ini NULL, kotak pesan tidak memiliki jendela pemilik.

[in] lpszText

Menunjuk ke string yang dihentikan null yang berisi pesan yang akan ditampilkan.

[in] lpszTitle

Menunjuk ke string yang dihentikan null yang digunakan untuk judul kotak dialog. Jika parameter ini NULL, judul default Kesalahan digunakan.

[in] fuStyle

Menentukan konten dan perilaku kotak dialog. Parameter ini bisa menjadi kombinasi dari nilai berikut.

Nilai	Makna
MB_ABORTRETRYIGNORE	Kotak pesan berisi tiga tombol perintah: Batalkan, Coba Lagi, dan Abaikan.
MB_APPLMODAL	Pengguna harus merespons kotak pesan sebelum terus bekerja di jendela yang diidentifikasi oleh parameter hWndOwner . Namun, pengguna dapat berpindah ke jendela aplikasi lain untuk bekerja. Tergantung pada hierarki jendela dalam aplikasi, pengguna mungkin dapat berpindah ke jendela lain dalam aplikasi. Semua jendela anak dari induk kotak pesan secara otomatis dinonaktifkan tetapi jendela pop-up tidak. MB_APPLMODAL adalah nilai default jika MB_SYSTEMMODAL atau MB_TASKMODAL tidak ditentukan.
MB_DEFAULT_DESKTOP_ONLY	Desktop yang saat ini menerima input harus berupa desktop default; jika tidak, fungsi gagal. Desktop default adalah desktop yang menjalankan aplikasi setelah pengguna masuk.
MB_DEFBUTTON1	Tombol pertama adalah tombol default. Perhatikan bahwa tombol pertama selalu default kecuali MB_DEFBUTTON2 atau MB_DEFBUTTON3 ditentukan.
MB_DEFBUTTON2	Tombol kedua adalah tombol default.
MB_DEFBUTTON3	Tombol ketiga adalah tombol default.
MB_DEFBUTTON4	Tombol keempat adalah tombol default.
MB_ICONASTERISK	Ikon yang terdiri dari huruf kecil dalam lingkaran muncul di kotak pesan.
MB_ICONEXCLAMATION	Ikon tanda seru muncul di kotak pesan.
MB_ICONHAND	Ikon tangan muncul di kotak pesan.
MB_ICONINFORMATION	Ikon yang terdiri dari huruf kecil dalam lingkaran muncul di kotak pesan.
MB_ICONQUESTION	Ikon tanda tanya muncul di kotak pesan.
MB_ICONSTOP	Ikon hentikan tanda muncul di kotak pesan.
MB_OK	Kotak pesan berisi satu tombol perintah: OK.
MB_OKCANCEL	Kotak pesan berisi dua tombol perintah: OK dan Batal.
MB_RETRYCANCEL	Kotak pesan berisi dua tombol perintah: Coba Lagi dan Batalkan.
MB_SERVICE_NOTIFICATION	Pemanggil adalah layanan yang memberi tahu pengguna tentang suatu peristiwa. Fungsi ini memunculkan kotak pesan di desktop aktif saat ini, bahkan jika tidak ada pengguna yang masuk ke komputer.
MB_SETFOREGROUND	Kotak pesan menjadi jendela latar depan. Secara internal, Windows memanggil fungsi SetForegroundWindow untuk kotak pesan.
MB_SYSTEMMODAL	Semua aplikasi ditangguhkan hingga pengguna merespons kotak pesan. Kecuali aplikasi menentukan MB_ICONHAND, kotak pesan tidak menjadi modal sampai setelah dibuat. Akibatnya, jendela pemilik dan jendela lain terus menerima pesan yang dihasilkan dari aktivasinya. Gunakan kotak pesan modal sistem untuk memberi tahu pengguna tentang kesalahan serius dan berpotensi merusak yang memerlukan perhatian segera, misalnya, kehabisan memori.
MB_TASKMODAL	Sama seperti MB_APPLMODAL kecuali bahwa semua jendela tingkat atas yang termasuk dalam tugas saat ini dinonaktifkan jika parameter hWndOwner adalah NULL. Gunakan bendera ini ketika aplikasi atau pustaka panggilan tidak memiliki handel jendela yang tersedia, tetapi masih perlu mencegah input ke jendela lain di aplikasi saat ini tanpa menangguhkan aplikasi lain.
MB_YESNO	Kotak pesan berisi dua tombol perintah: Ya dan Tidak.
MB_YESNOCANCEL	Kotak pesan berisi tiga tombol perintah: Ya, Tidak, dan Batal.

Nilai kembali

Jika fungsi gagal, atau jika tidak ada cukup memori untuk membuat kotak pesan, nilai yang dikembalikan adalah nol.

Jika fungsi berhasil, nilai yang dikembalikan adalah salah satu nilai item menu berikut yang dikembalikan oleh kotak dialog.

Catatan Jika kotak pesan memiliki tombol Batal , fungsi mengembalikan nilai IDCANCEL jika tombol ESC ditekan atau tombol Batal diklik. Jika kotak pesan tidak memiliki tombol Batal , menekan ESC tidak berpengaruh.

Menampilkan kode	Deskripsi
IDABORT	Tombol batalkan dipilih.
IDCANCEL	Tombol Batal dipilih.
IDIGNORE	Tombol Abaikan dipilih.
IDNO	Tombol tidak dipilih.
IDOK	Tombol OK dipilih.
IDRETRY	Tombol coba lagi dipilih.
IDYES	Tombol Ya dipilih.

Keterangan

Fungsi WlxMessageBox tidak menangani peristiwa SAS , dan tidak cocok untuk kotak dialog keamanan. Gunakan fungsi WlxDialogBox, WlxDialogBoxIndirect, atau WlxDialogBoxIndirectParam untuk kotak dialog keamanan.

WlxMessageBox menduplikasi fungsi Windows MessageBox , dengan pengecualian bahwa fungsi ini juga memungkinkan Winlogon kehabisan waktu kotak dialog. Untuk informasi selengkapnya, lihat MessageBox.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	winwlx.h