PWLX_DIALOG_BOX_INDIRECT_PARAM回呼函式 (winwlx.h)

發行項
03/08/2023

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

由 GINA呼叫以初始化對話方塊控制項，然後從記憶體中的對話方塊範本建立強制回應對話方塊。

注意 Windows Vista 中會忽略 GINA DLL。

語法

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

參數

[in] hWlx

指定在WlxInitialize呼叫中傳遞至 GINA 的Winlogon控制碼。

[in] hInst

指定建立對話方塊之模組的實例。

[in] hDialogTemplate

指定全域記憶體物件的位址，其中包含用來建立對話方塊的對話方塊範本。此範本的格式為 DLGTEMPLATE 結構，後面接著一或多個 DLGITEMTEMPLATE 結構。如需這些結構的完整描述，請參閱平臺 SDK。

[in] hwndOwner

指定擁有對話方塊的視窗。

[in] dlgprc

指向對話方塊程式。如需對話方塊程式的詳細資訊，請參閱 Platform SDK 中的 DialogProc 回呼函式描述。

[in] dwInitParam

指定用來初始化對話方塊控制項的值。這個值會傳遞至WM_INITDIALOG訊息之 lParam參數中的對話方塊。

傳回值

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

傳回碼	描述
WLX_DLG_INPUT_TIMEOUT	輸入逾時。
WLX_DLG_SAS	發生安全注意順序 (SAS) 事件。
WLX_DLG_SCREEN_SAVER_TIMEOUT	螢幕節省時間逾時。
WLX_DLG_USER_LOGOFF	使用者已登出。

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

備註

WlxDialogBoxIndirectParam 會複製 Windows DialogBoxIndirectParam 函式，並允許 Winlogon 終止對話方塊。如需詳細資訊，請參閱 DialogBoxIndirectParam。

規格需求


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