PWLX_DIALOG_BOX回呼函式 (winwlx.h)

  • 發行項

[從 Windows Server 2008 和 Windows Vista 起，不再提供 WlxDialogBox 函式。

由 GINA 呼叫，以從對話框範本建立強制響應對話方塊。

注意 Windows Vista 中會忽略 GINA DLL。
 

語法

PWLX_DIALOG_BOX PwlxDialogBox;

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

參數

[in] hWlx

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

[in] hInst

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

[in] lpszTemplate

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

[in] hwndOwner

指定擁有對話框的視窗。

[in] dlgprc

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

傳回值

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

傳回碼 Description
WLX_DLG_INPUT_TIMEOUT
 輸入逾時。
WLX_DLG_SAS
 發生安全 注意順序 (SAS) 事件。
WLX_DLG_SCREEN_SAVER_TIMEOUT
 屏幕保護程式逾時。
WLX_DLG_USER_LOGOFF
 用戶註銷。
 

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

備註

GINA 必須使用 Winlogon WlxDialogBox 函式，而不是 Windows DialogBox 宏。 WlxDialogBox 會複製 Windows DialogBox 宏，也允許 Winlogon 終止對話方塊。 如需詳細資訊，請參閱 DialogBox。

規格需求

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

另請參閱

DialogBox

DialogProc

EndDialog

MAKEINTRESOURCE

WlxInitialize