[Now Supported on Windows NT]
function creates, displays, and operates a message box. The message box
contains application-defined message text and title, any icon, and any combination
of predefined push buttons.
| LPMSGBOXPARAMS lpMsgBoxParams
||// address of structure for message box parameters
Pointer to a MSGBOXPARAMS
structure that contains information used to display the message box.
The return value is zero if there is not enough memory to create the message
If the function succeeds, the return value is one of the following menu-item
values returned by the dialog box:
||Abort button was selected.
||Cancel button was selected.
||Ignore button was selected.
||No button was selected.
||OK button was selected.
||Retry button was selected.
||Yes button was selected.
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 selected. If the message box has no
Cancel button, pressing ESC has no effect.
When you use a system-modal message box to indicate that the system is low on
memory, the strings pointed to by the lpszText
members of the MSGBOXPARAMS
structure should not be taken from a resource file, because an attempt to
load the resource may fail.
When an application calls MessageBoxIndirect
and specifies the MB_ICONHAND and MB_SYSTEMMODAL flags for the dwStyle
member of the MSGBOXPARAMS
structure, Windows displays the resulting message box regardless of available
memory. When these flags are specified, Windows limits the length of the
message box text to three lines. Windows does not
automatically break the lines to fit in the message box, however, so the
message string must contain carriage returns to break the lines at the appropriate
If you create a message box while a dialog box is present, use the handle of
the dialog box as the hWnd
parameter. The hWnd
parameter should not identify a child window, such as a control in a dialog
The system can support a maximum of 16,364 window handles.
- Software for developers
Software for Android Developers
- More information resources
Unix Manual Pages