Edit

Share via

PWLX_DIALOG_BOX callback function (winwlx.h)

  • Article

[The WlxDialogBox function is no longer available for use as of Windows Server 2008 and Windows Vista.]

Called by the GINA to create a modal dialog box from a dialog box template.

Note   GINA DLLs are ignored in Windows Vista.
 

Syntax

PWLX_DIALOG_BOX PwlxDialogBox;

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

Parameters

[in] hWlx

Specifies the Winlogon handle passed to GINA in the WlxInitialize call.

[in] hInst

Specifies an instance of the module whose executable file contains the dialog box template.

[in] lpszTemplate

Specifies the dialog box template. This parameter is either the address of a null-terminated character string that specifies the name of the dialog box template, or an integer value that specifies the resource identifier of the dialog box template. If the parameter specifies a resource identifier, its high-order word must be zero and its low-order word must contain the identifier. You can use the MAKEINTRESOURCE macro to create this value.

[in] hwndOwner

Specifies the window that owns the dialog box.

[in] dlgprc

Points to the dialog box procedure. For more information about the dialog box procedure, see the DialogProc callback function.

Return value

If the WlxDialogBox function succeeds, the return value is the nResult parameter given in the call to the EndDialog function used to terminate the dialog box. The following table lists some possible success return values.

Return code Description
WLX_DLG_INPUT_TIMEOUT
 Input timed out.
WLX_DLG_SAS
 A secure attention sequence (SAS) event occurred.
WLX_DLG_SCREEN_SAVER_TIMEOUT
 The screen saver timed out.
WLX_DLG_USER_LOGOFF
 The user logged off.
 

If the function fails, the return value is –1.

Remarks

GINA must use the Winlogon WlxDialogBox function, not the Windows DialogBox macro. WlxDialogBox duplicates the Windows DialogBox macro, and also allows Winlogon to terminate the dialog box. For more information, see DialogBox.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header winwlx.h

See also

DialogBox

DialogProc

EndDialog

MAKEINTRESOURCE

WlxInitialize