Skip to content

Latest commit

 

History

History
441 lines (366 loc) · 12.2 KB

nc-winwlx-pwlx_message_box.md

File metadata and controls

441 lines (366 loc) · 12.2 KB
Raw
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_MESSAGE_BOX
PWLX_MESSAGE_BOX (winwlx.h)
Called by GINA to create, display, and operate a message box.
MB_ABORTRETRYIGNORE
MB_APPLMODAL
MB_DEFAULT_DESKTOP_ONLY
MB_DEFBUTTON1
MB_DEFBUTTON2
MB_DEFBUTTON3
MB_DEFBUTTON4
MB_ICONASTERISK
MB_ICONEXCLAMATION
MB_ICONHAND
MB_ICONINFORMATION
MB_ICONQUESTION
MB_ICONSTOP
MB_OK
MB_OKCANCEL
MB_RETRYCANCEL
MB_SERVICE_NOTIFICATION
MB_SETFOREGROUND
MB_SYSTEMMODAL
MB_TASKMODAL
MB_YESNO
MB_YESNOCANCEL
PWLX_MESSAGE_BOX
PWLX_MESSAGE_BOX callback
WlxMessageBox
WlxMessageBox callback function [Security]
_gina_wlxmessagebox
security.wlxmessagebox
winwlx/WlxMessageBox
security\wlxmessagebox.htm
security
5ae99416-c502-46f6-ba58-7385ce410e48
12/05/2018
MB_ABORTRETRYIGNORE, MB_APPLMODAL, MB_DEFAULT_DESKTOP_ONLY, MB_DEFBUTTON1, MB_DEFBUTTON2, MB_DEFBUTTON3, MB_DEFBUTTON4, MB_ICONASTERISK, MB_ICONEXCLAMATION, MB_ICONHAND, MB_ICONINFORMATION, MB_ICONQUESTION, MB_ICONSTOP, MB_OK, MB_OKCANCEL, MB_RETRYCANCEL, MB_SERVICE_NOTIFICATION, MB_SETFOREGROUND, MB_SYSTEMMODAL, MB_TASKMODAL, MB_YESNO, MB_YESNOCANCEL, PWLX_MESSAGE_BOX, PWLX_MESSAGE_BOX callback, WlxMessageBox, WlxMessageBox callback function [Security], _gina_wlxmessagebox, security.wlxmessagebox, winwlx/WlxMessageBox
winwlx.h
Windows
Windows XP [desktop apps only]
Windows Server 2003 [desktop apps only]
Windows
19H1
PWLX_MESSAGE_BOX
winwlx/PWLX_MESSAGE_BOX
c++
APIRef
kbSyntax
UserDefined
winwlx.h
WlxMessageBox

PWLX_MESSAGE_BOX callback function

-description

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

The WlxMessageBox function is called by GINA to create, display, and operate a message box.

Note   GINA DLLs are ignored in Windows Vista.
 

-parameters

-param hWlx [in]

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

-param hwndOwner [in]

Specifies the owner window of the message box to be created. If this parameter is NULL, the message box has no owner window.

-param lpszText [in]

Points to a null-terminated string that contains the message to be displayed.

-param lpszTitle [in]

Points to a null-terminated string used for the dialog box title. If this parameter is NULL, the default title Error is used.

-param fuStyle [in]

Specifies the content and behavior of the dialog box. This parameter can be a combination of the following values.

Value Meaning
MB_ABORTRETRYIGNORE
 The message box contains three command buttons: Abort, Retry, and Ignore.
MB_APPLMODAL
 The user must respond to the message box before continuing to work in the window identified by the hWndOwner parameter. However, the user can move to windows of other applications to work.

Depending on the hierarchy of windows in the application, the user may be able to move to other windows within the application. All child windows of the parent of the message box are automatically disabled but pop-up windows are not.

MB_APPLMODAL is the default value if neither MB_SYSTEMMODAL nor MB_TASKMODAL is specified.
MB_DEFAULT_DESKTOP_ONLY
 The desktop currently receiving input must be a default desktop; otherwise, the function fails. A default desktop is one on which an application runs after the user has logged on.
MB_DEFBUTTON1
 The first button is the default button. Note that the first button is always the default unless MB_DEFBUTTON2 or MB_DEFBUTTON3 is specified.
MB_DEFBUTTON2
 The second button is a default button.
MB_DEFBUTTON3
 The third button is a default button.
MB_DEFBUTTON4
 The fourth button is a default button.
MB_ICONASTERISK
 An icon that consists of a lowercase letter in a circle appears in the message box.
MB_ICONEXCLAMATION
 An exclamation point icon appears in the message box.
MB_ICONHAND
 A hand icon appears in the message box.
MB_ICONINFORMATION
 An icon that consists of a lowercase letter in a circle appears in the message box.
MB_ICONQUESTION
 A question mark icon appears in the message box.
MB_ICONSTOP
 A stop sign icon appears in the message box.
MB_OK
 The message box contains one command button: OK.
MB_OKCANCEL
 The message box contains two command buttons: OK and Cancel.
MB_RETRYCANCEL
 The message box contains two command buttons: Retry and Cancel.
MB_SERVICE_NOTIFICATION
 The caller is a service notifying the user of an event. The function brings up a message box on the current active desktop, even if there is no user logged on to the computer.
MB_SETFOREGROUND
 The message box becomes the foreground window. Internally, Windows calls the SetForegroundWindow function for the message box.
MB_SYSTEMMODAL
 All applications are suspended until the user responds to the message box. Unless the application specifies MB_ICONHAND, the message box does not become modal until after it is created. Consequently, the owner window and other windows continue to receive messages resulting from its activation. Use system-modal message boxes to notify the user of serious, potentially damaging errors that require immediate attention, for example, running out of memory.
MB_TASKMODAL
 Same as MB_APPLMODAL except that all the top-level windows that belong to the current task are disabled if the hWndOwner parameter is NULL. Use this flag when the calling application or library does not have a window handle available, but still needs to prevent input to other windows in the current application without suspending other applications.
MB_YESNO
 The message box contains two command buttons: Yes and No.
MB_YESNOCANCEL
 The message box contains three command buttons: Yes, No, and Cancel.

-returns

If the function fails, or if there is not enough memory to create the message box, the return value is zero.

If the function succeeds, the return value is one of the following menu item values returned by the dialog box.

Note  If a message box has a Cancel button, the function returns the IDCANCEL value if either the ESC key is pressed or the Cancel button is clicked. If the message box has no Cancel button, pressing ESC has no effect.
 
Return code Description
IDABORT
 Abort button was selected.
IDCANCEL
 Cancel button was selected.
IDIGNORE
 Ignore button was selected.
IDNO
 A button was not selected.
IDOK
 OK button was selected.
IDRETRY
 Retry button was selected.
IDYES
 Yes button was selected.

-remarks

The WlxMessageBox function does not handle SAS events, and is not suitable for security dialog boxes. Use the WlxDialogBox, WlxDialogBoxIndirect, or WlxDialogBoxIndirectParam function for security dialog boxes.

WlxMessageBox duplicates the Windows MessageBox function, with the exception that this function also allows Winlogon to time out the dialog box. For more information, see MessageBox.

-see-also

MessageBox

SetForegroundWindow

WlxDialogBox

WlxDialogBoxIndirect

WlxDialogBoxIndirectParam

WlxInitialize