Windows Dev Center

Expand Minimize

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.

Note   GINA DLLs are ignored in Windows Vista.

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

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

Winwlx.h

See also

DialogBoxIndirect
DialogProc
DLGTEMPLATE
DLGITEMTEMPLATE
EndDialog
WlxInitialize

 

 

Community Additions

ADD
Show:
© 2015 Microsoft