nc-winwlx-pwlx_dialog_box_param.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NC:winwlx.PWLX_DIALOG_BOX_PARAM	PWLX_DIALOG_BOX_PARAM (winwlx.h)	Called by GINA to initialize dialog box controls and then create a modal dialog box from a dialog box template resource.	PWLX_DIALOG_BOX_PARAM PWLX_DIALOG_BOX_PARAM callback WlxDialogBoxParam WlxDialogBoxParam callback function [Security] _gina_wlxdialogboxparam security.wlxdialogboxparam winwlx/WlxDialogBoxParam	security\wlxdialogboxparam.htm	security	0b4543e1-066b-4d19-9b15-90d966d25154	12/05/2018	PWLX_DIALOG_BOX_PARAM, PWLX_DIALOG_BOX_PARAM callback, WlxDialogBoxParam, WlxDialogBoxParam callback function [Security], _gina_wlxdialogboxparam, security.wlxdialogboxparam, winwlx/WlxDialogBoxParam	winwlx.h		Windows	Windows XP [desktop apps only]	Windows Server 2003 [desktop apps only]													Windows			19H1	PWLX_DIALOG_BOX_PARAM winwlx/PWLX_DIALOG_BOX_PARAM	c++	APIRef kbSyntax	UserDefined	winwlx.h	WlxDialogBoxParam

PWLX_DIALOG_BOX_PARAM callback function

-description

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

Called by GINA to initialize dialog box controls and then create a modal dialog box from a dialog box template resource.

Note   GINA DLLs are ignored in Windows Vista.

 

-parameters

-param hWlx [in]

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

-param hInst [in]

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

-param lpszTemplate [in]

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.

-param hwndOwner [in]

Specifies the window that owns the dialog box.

-param dlgprc [in]

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

-param dwInitParam [in]

Specifies the value to pass to the dialog box in the lParam parameter of the WM_INITDIALOG message.

-returns

If the WlxDialogBoxParam function succeeds, the return value is the value of 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

WlxDialogBoxParam duplicates the Windows DialogBoxParam function, and also allows Winlogon to terminate the dialog box. For more information, see DialogBoxParam.

-see-also

DialogBoxParam

DialogProc

EndDialog

MAKEINTRESOURCE

WlxInitialize