PWLX_DIALOG_BOX_PARAM回呼函式 (winwlx.h)

發行項
03/04/2024

[WlxDialogBoxParam 函式已不再可供 Windows Server 2008 和 Windows Vista 使用。]

由 GINA 呼叫以初始化對話方塊控制件，然後從對話框範本資源建立強制回應對話方塊。

注意 Windows Vista 中會忽略 GINA DLL。

語法

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
)
{...}

參數

[in] hWlx

指定在 WlxInitialize 呼叫中傳遞至 GINA 的 Winlogon 句柄。

[in] hInst

指定模組的實例，其可執行檔包含對話框範本。

[in] lpszTemplate

指定對話框範本。此參數是指定對話框範本名稱之 Null 終止字元字串的位址，或指定對話框範本之資源識別碼的整數值。如果參數指定資源標識元，則其高序字必須是零，且其低序字必須包含標識符。您可以使用 MAKEINTRESOURCE 宏來建立此值。

[in] hwndOwner

指定擁有對話框的視窗。

[in] dlgprc

指向對話框程式。如需對話框程式的詳細資訊，請參閱 DialogProc。

[in] dwInitParam

指定要在WM_INITDIALOG訊息的 lParam 參數中傳遞至對話框的值。

傳回值

如果 WlxDialogBoxParam 函式成功，傳回值就是呼叫 EndDialog 函式中用來終止對話框的 nResult 參數值。下表列出一些可能的成功傳回值。

傳回碼	Description
WLX_DLG_INPUT_TIMEOUT	輸入逾時。
WLX_DLG_SAS	發生安全注意順序 (SAS) 事件。
WLX_DLG_SCREEN_SAVER_TIMEOUT	螢幕節省時間逾時。
WLX_DLG_USER_LOGOFF	用戶已註銷。

如果函式失敗，傳回值為 –1。

備註

WlxDialogBoxParam 會複製 Windows DialogBoxParam 函式，並允許 Winlogon 終止對話框。如需詳細資訊，請參閱 DialogBoxParam。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	winwlx.h