WlxDialogBoxIndirect function
[The WlxDialogBoxIndirect function is no longer available for use as of Windows Server 2008 and Windows Vista.]
Called by GINA to create a modal dialog box from a dialog box template in memory.
Syntax
int WlxDialogBoxIndirect(
_In_ HANDLE hWlx,
_In_ HANDLE hInst,
_In_ LPCDLGTEMPLATE hDialogTemplate,
_In_ HWND hwndOwner,
_In_ DLGPROC dlgprc
);
Parameters
- hWlx [in]
-
Winlogon handle provided to GINA in the WlxInitialize call.
- hInst [in]
-
Identifies the instance of the module that creates the dialog box.
- hDialogTemplate [in]
-
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.
- hwndOwner [in]
-
Identifies 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.
Return value
If the WlxDialogBoxIndirect 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 |
|---|---|
|
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
WlxDialogBoxIndirect duplicates the Windows DialogBoxIndirect macro, and also allows Winlogon to terminate the dialog box. For more information, see DialogBoxIndirect.
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 |
|
See also