PWLX_DIALOG_BOX_INDIRECT_PARAM callback function (winwlx.h)
[The WlxDialogBoxIndirectParam 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 in memory.
Syntax
PWLX_DIALOG_BOX_INDIRECT_PARAM PwlxDialogBoxIndirectParam;
int PwlxDialogBoxIndirectParam(
[in] HANDLE hWlx,
[in] HANDLE hInst,
[in] LPCDLGTEMPLATE hDialogTemplate,
[in] HWND hwndOwner,
[in] DLGPROC dlgprc,
[in] LPARAM dwInitParam
)
{...}
Parameters
[in] hWlx
Specifies the Winlogon handle passed to GINA in the WlxInitialize call.
[in] hInst
Specifies the instance of the module that creates the dialog box.
[in] hDialogTemplate
Specifies the address of a global memory object that contains a dialog box template used to create the dialog box. The template is in the form of a DLGTEMPLATE structure followed by one or more DLGITEMTEMPLATE structures. For a full description of these structures, see the Platform SDK.
[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 description of the DialogProc callback function in the Platform SDK.
[in] dwInitParam
Specifies the value used to initialize the dialog box control. This value is passed to the dialog box in the lParam parameter of the WM_INITDIALOG message.
Return value
If the function succeeds, the function returns 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 |
---|---|
|
Input timed out. |
|
A secure attention sequence (SAS) event occurred. |
|
The screen saver timed out. |
|
The user logged off. |
If the function fails, the return value is –1.
Remarks
WlxDialogBoxIndirectParam duplicates the Windows DialogBoxIndirectParam function and also allows Winlogon to terminate the dialog box. For more information, see DialogBoxIndirectParam.
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 |