PWLX_DIALOG_BOX_PARAM fungsi panggilan balik (winwlx.h)

Artikel
03/08/2023

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

Dipanggil oleh GINA untuk menginisialisasi kontrol kotak dialog lalu membuat kotak dialog modal dari sumber daya templat kotak dialog.

Catatan DLL GINA diabaikan di Windows Vista.

Sintaks

PWLX_DIALOG_BOX_PARAM PwlxDialogBoxParam;

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

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 urutan rendahnya 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 DialogProc.

[in] dwInitParam

Menentukan nilai yang akan diteruskan ke kotak dialog dalam parameter lParam dari pesan WM_INITDIALOG .

Nilai kembali

Jika fungsi WlxDialogBoxParam berhasil, nilai yang dikembalikan adalah nilai 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 pengaman layar habis.
WLX_DLG_USER_LOGOFF	Pengguna keluar.

Jika fungsi gagal, nilai yang dikembalikan adalah –1.

Keterangan

WlxDialogBoxParam menduplikasi fungsi Windows DialogBoxParam , dan juga memungkinkan Winlogon untuk mengakhiri kotak dialog. Untuk informasi selengkapnya, lihat DialogBoxParam.

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