| VOID FatalAppExit(uAction, lpszMessageText) | |||||
| UINT uAction; | /* must be zero | */ | |||
| LPCTSTR lpszMessageText; | /* string to display in message box | */ | |||
The FatalAppExit function displays a message box and terminates the application when the message box is closed. If Windows is running with a kernel debugger, the message box gives the user the opportunity to terminate the application or to cancel the message box and return to the caller.
uAction
This parameter is reserved and must be set to 0.
lpszMessageText
Points to a null-terminated string that is displayed in the message box. The message is displayed on a single line. To accommodate low-resolution displays, the string should be no more than 35 characters in length.
This function does not return a value.
An application should call the FatalAppExit function only when it is not capable of terminating any other way. The FatalAppExit function may not always free an application's memory or close its files, and it may cause a general failure of Windows. An application that encounters an unexpected error should terminate by freeing all its memory and then returning from its main message loop.
The FatalAppExit function may be used as either a wide-character function (where text arguments must use Unicode) or an ANSI function (where text arguments must use characters from the Windows 3.x character set installed).
FatalExit