PWLX_DIALOG_BOX fungsi panggilan balik (winwlx.h)

Artikel
03/08/2023

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

Dipanggil oleh GINA untuk membuat kotak dialog modal dari templat kotak dialog.

Catatan DLL GINA diabaikan di Windows Vista.

Sintaks

PWLX_DIALOG_BOX PwlxDialogBox;

int PwlxDialogBox(
  [in] HANDLE hWlx,
  [in] HANDLE hInst,
  [in] LPWSTR lpszTemplate,
  [in] HWND hwndOwner,
  [in] DLGPROC dlgprc
)
{...}

Parameter

[in] hWlx

Menentukan handel Winlogon yang diteruskan ke GINA dalam panggilan WlxInitialize .

[in] hInst

Menentukan instans modul yang file yang dapat dieksekusi berisi templat kotak dialog.

[in] lpszTemplate

Menentukan templat kotak dialog. Parameter ini adalah alamat string karakter yang dihentikan null yang menentukan nama templat kotak dialog, atau nilai bilangan bulat yang menentukan pengidentifikasi sumber daya templat kotak dialog. Jika parameter menentukan pengidentifikasi sumber daya, kata urutan tingginya harus nol dan kata berurutan rendah harus berisi pengidentifikasi. Anda dapat menggunakan makro MAKEINTRESOURCE untuk membuat nilai ini.

[in] hwndOwner

Menentukan jendela yang memiliki kotak dialog.

[in] dlgprc

Menunjuk ke prosedur kotak dialog. Untuk informasi selengkapnya tentang prosedur kotak dialog, lihat fungsi panggilan balik DialogProc .

Nilai kembali

Jika fungsi WlxDialogBox berhasil, nilai yang dikembalikan adalah parameter nResult yang diberikan dalam panggilan ke fungsi EndDialog yang digunakan untuk mengakhiri kotak dialog. Tabel berikut ini mencantumkan beberapa kemungkinan nilai pengembalian keberhasilan.

Menampilkan kode	Deskripsi
WLX_DLG_INPUT_TIMEOUT	Waktu input habis.
WLX_DLG_SAS	Peristiwa urutan perhatian aman (SAS) terjadi.
WLX_DLG_SCREEN_SAVER_TIMEOUT	Waktu penghemat layar habis.
WLX_DLG_USER_LOGOFF	Pengguna keluar.

Jika fungsi gagal, nilai yang dikembalikan adalah –1.

Keterangan

GINA harus menggunakan fungsi Winlogon WlxDialogBox , bukan makro Windows DialogBox . WlxDialogBox menduplikasi makro Windows DialogBox , dan juga memungkinkan Winlogon untuk mengakhiri kotak dialog. Untuk informasi selengkapnya, lihat Kotak Dialog.

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

Lihat juga