Virtual Devices (3.1) (vdag31qh.hlp) (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
Fatal_Error
                                                     Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
include vmm.inc
 
Fatal_Error Msg_Ptr, Exit_Flags
 
The Fatal_Error macro calls the Fatal_Error_Handler service which terminates
Windows. A virtual device typically calls this macro in response to an
unrecoverable error. The macro passes the Msg_Ptr and Exit_Flags parameters
(if given) to Fatal_Error_Handler.
 
Parameter   Description
────────────────────────────────────────────────────────────────────────────
 
Msg_Ptr     Points to a zero-terminated string. This parameter is optional.
 
Exit_Flags  Specifies the exit flags. This optional parameter can be a
            combination of the following values:
 
            Value            Meaning
            ────────────────────────────────────────────────────────────────
            EF_Hang_On_Exit  Hangs the system on a fatal exit.
 
Return Value
 
This macro never returns.
 
Example
 
The following example exits Windows without displaying an error message:
 
Fatal_Error
 
The following example exits Windows and prints the error message pointed to
by My_Err_Msg:
 
Fatal_Error OFFSET32 My_Err_Msg
 
See Also
 
Fatal_Error_Handler