PWLX_DIALOG_BOX_INDIRECT_PARAM fungsi panggilan balik (winwlx.h)

Artikel
08/28/2023

[Fungsi WlxDialogBoxIndirectParam 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 templat kotak dialog dalam memori.

Catatan DLL GINA diabaikan di Windows Vista.

Sintaks

PWLX_DIALOG_BOX_INDIRECT_PARAM PwlxDialogBoxIndirectParam;

int PwlxDialogBoxIndirectParam(
  [in] HANDLE hWlx,
  [in] HANDLE hInst,
  [in] LPCDLGTEMPLATE hDialogTemplate,
  [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 membuat kotak dialog.

[in] hDialogTemplate

Menentukan alamat objek memori global yang berisi templat kotak dialog yang digunakan untuk membuat kotak dialog. Templat dalam bentuk struktur DLGTEMPLATE diikuti oleh satu atau beberapa struktur DLGITEMTEMPLATE . Untuk deskripsi lengkap tentang struktur ini, lihat Platform SDK.

[in] hwndOwner

Menentukan jendela yang memiliki kotak dialog.

[in] dlgprc

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

[in] dwInitParam

Menentukan nilai yang digunakan untuk menginisialisasi kontrol kotak dialog. Nilai ini diteruskan ke kotak dialog dalam parameter lParam dari pesan WM_INITDIALOG .

Nilai kembali

Jika fungsi berhasil, fungsi mengembalikan 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

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

Persyaratan


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