FatalAppExit

3.0

  void FatalAppExit(fuAction, lpszMessageText)    
  UINT fuAction; /* must be zero, */  
  LPCSTR 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 the user is running the debugging version of the Windows operating system, the message box gives the user the opportunity to terminate the application or to cancel the message box and return to the caller.

Parameters

fuAction

Reserved; must be zero.

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 screens, the string should contain no more than 35 characters.

Return Value

This function does not return a value.

Comments

An application should call the FatalAppExit function only when it is incapable of terminating any other way. FatalAppExit 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 returning from its main message loop.

See Also

FatalExit, TerminateApp