PWLX_DIALOG_BOX_INDIRECT回呼函式 (winwlx.h)

發行項
08/28/2023

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

由 GINA呼叫，從記憶體中的對話方塊範本建立強制回應對話方塊。

注意 Windows Vista 中會忽略 GINA DLL。

語法

PWLX_DIALOG_BOX_INDIRECT PwlxDialogBoxIndirect;

int PwlxDialogBoxIndirect(
  [in] HANDLE hWlx,
  [in] HANDLE hInst,
  [in] LPCDLGTEMPLATE hDialogTemplate,
  [in] HWND hwndOwner,
  [in] DLGPROC dlgprc
)
{...}

參數

[in] hWlx

在 WlxInitialize呼叫中提供給 GINA 的 Winlogon 控制碼。

[in] hInst

識別建立對話方塊之模組的實例。

[in] hDialogTemplate

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

[in] hwndOwner

識別擁有對話方塊的視窗。

[in] dlgprc

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

傳回值

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

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

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

備註

WlxDialogBoxIndirect 會複製 Windows DialogBoxIndirect 宏，也允許 Winlogon 終止對話方塊。如需詳細資訊，請參閱 DialogBoxIndirect。

規格需求


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