This is an old revision of the document!
This call allows an OS/2 process to receive hard error notification without generating a hard error signal.
Syntax
DosError (Flag)
Parameters
;Flags (USHORT) - input : Bit field, defined in the following example (the unused high-order bits are reserved and must be set to zero). Bit Description 15-2 Reserved, set to zero.
1 0 = Enable exception popups.
1 = Disable exception popups.
0 0 = Disable hard error popups (fail requests).
1 = Enable hard error popups.
Return Code
rc (USHORT) - return Return code descriptions are: *0 NO_ERROR *87 ERROR_INVALID_PARAMETER
Remarks
DosError allows an OS/2 process to disable user notification if a program (or untrapped numeric processor) exception occurs. If end user notification is disabled, and if one of these exceptions occurs, the process is terminated.
Hard errors generated under a process that has issued a DosError call are failed, and the appropriate error code is returned. The default situation is both hard error pop-ups and exception pop-ups are enabled, if DosError is not issued.
Family API Considerations
Some options operate differently in the DOS mode than in the OS/2 mode. Therefore, the following restriction applies to DosError when coding for the DOS mode:
For Flag, a value of 0000 causes all subsequent INT 24s to be failed until a subsequent call with a value of 1 is issued.
Note: Since INT 24 is not issued in DOS mode, this call has no effect when running in DOS mode.
Bindings
C Binding
<PRE> #define INCL_DOSMISC
USHORT rc = DosError(Flag); USHORT Flags; /* Action flags */
USHORT rc; /* return code */ </PRE>
MASM Binding
<PRE> EXTRN DosError:FAR INCL_DOSMISC EQU 1
PUSH WORD Flags ;Action flags CALL DosError
Returns WORD </PRE>
Example Code
This example disables hard error popups and exception popups, then re-enables them. <PRE> #define INCL_DOSQUEUES
#define ENABLE_EXCEPTION 0 #define DISABLE_EXCEPTION 2 #define ENABLE_HARDERROR 1 #define DISABLE_HARDERROR 0 #define DISABLE_ERRORPOPUPS DISABLE_EXCEPTION | DISABLE_HARDERROR #define ENABLE_ERRORPOPUPS ENABLE_EXCEPTION | ENABLE_HARDERROR
USHORT rc;
rc = DosError(DISABLE_ERRORPOPUPS); /* Action flag */ rc = DosError(ENABLE_ERRORPOPUPS); /* Action flag */ </PRE>
Note
Text based on http://www.edm2.com/index.php/DosError_(FAPI)