Export (0) Print
Expand All
Expand Minimize

WlxDialogBoxParam function

[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.

Syntax


int WlxDialogBoxParam(
  _In_  HANDLE hWlx,
  _In_  HANDLE hInst,
  _In_  LPWSTR lpszTemplate,
  _In_  HWND hwndOwner,
  _In_  DLGPROC dlgprc,
  _In_  LPARAM dwInitParam
);

Parameters

hWlx [in]

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

hInst [in]

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

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.

hwndOwner [in]

Specifies the window that owns the dialog box.

dlgprc [in]

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

dwInitParam [in]

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

Return value

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 codeDescription
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.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

End of client support

Windows XP

End of server support

Windows Server 2003

Header

Winwlx.h

See also

DialogBoxParam
EndDialog
DialogProc
MAKEINTRESOURCE
WlxInitialize

 

 

Community Additions

ADD
Show:
© 2014 Microsoft