_hardretn

Hardware error handler.

Defined in header <dos.h>

Syntax

#include <dos.h>
void _hardretn(int retn);

Portability

Remarks

The error handler established by _harderr can return directly to the application program by calling _hardretn.

If the DOS function that caused the error is less than 0x38, and it is a function that can indicate an error condition, then _hardretn will return to the application program with the AL register set to 0xFF. The retn argument is ignored for all DOS functions less than 0x38.

If the DOS function is greater than or equal to 0x38, the retn argument should be a DOS error code; it is returned to the application program in the AX register. The carry flag is also set to indicate to the application that the operation resulted in an error.

Return value

The _hardresume function does not return a value, and does not return to the caller.

See also

• _harderr
• _hardresume

Example

See the example  for _harderr.

Differences from modern implementations

Nothing recorded yet.

Modern references

• Microsoft C runtime (search)

These are search links, not yet checked by hand.

Extraction notes

• heading `hardretn` read as `_hardretn`

Stable link: /3.1/dos.h/_hardretn/ · short form /3.1/_hardretn/