ERROR

ERROR STRUC

errAX dw ? ;ax register

errBX dw ? ;bx register

errCX dw ? ;cx register

errDX dw ? ;dx register

errSI dw ? ;si register

errDI dw ? ;di register

errDS dw ? ;ds register

errES dw ? ;es register

errReserved dw ? ;reserved 16 bits

errUID dw ? ;user (computer) ID (0 = local computer)

errPID dw ? ;program ID (0 = local program)

ERROR ENDS

The ERROR structure contains information about the current error.

Fields

errAX

Specifies the error value. For a table of error values, see Appendix C, “Error Values.”

errBX

Specifies the error class in the high-order byte and the suggested action in the low-order byte. The error class may be one of the following values:

Value Meaning

ERRCLASS_OUTRES (01h) Out of resource, such as storage.
ERRCLASS_TEMPSIT (02h) Not an error, but a temporary situation that is expected to end, such as a locked region in a file.
ERRCLASS_AUTH (03h) Authorization problem.
ERRCLASS_INTRN (04h) Internal error in system.
ERRCLASS_HRDFAIL (05h) Hardware failure.
ERRCLASS_SYSFAIL (06h) System software failure not the fault of the active program (caused by missing or incorrect configuration files, for example).
ERRCLASS_APPERR (07h) Application error.
ERRCLASS_NOTFND (08h) File or item not found.
ERRCLASS_BADFMT (09h) File or item with an invalid format or type.
ERRCLASS_LOCKED (0Ah) Interlocked file or item.
ERRCLASS_MEDIA (0Bh) Wrong disk in drive, bad spot on disk, or other storage-medium problem.
ERRCLASS_ALREADY (0Ch) Existing file or item.
ERRCLASS_UNK (0Dh) Unknown.

The suggested action may be one of the following values:

Value Meaning

ERRACT_RETRY (01h) Retry immediately.
ERRACT_DLYRET (02h) Delay and retry.
ERRACT_USER (03h) Bad user input—get new values.
ERRACT_ABORT (04h) Terminate in an orderly manner.
ERRACT_PANIC (05h) Terminate immediately.
ERRACT_IGNORE (06h) Ignore the error.
ERRACT_INTRET (07h) Prompt the user to remove the cause of the error (to change disks, for example) and then retry.

errCX

Specifies the error-location value. This value can be one of the following:

Value Location

ERRLOC_UNK (01h) Unknown
ERRLOC_DISK (02h) Random-access device, such as a disk drive
ERRLOC_NET (03h) Network
ERRLOC_SERDEV (04h) Serial device
ERRLOC_MEM (05h) Memory

errDX

Specifies the DX register contents at the time the error occurred.

errSI

Specifies the SI register contents at the time the error occurred.

errDI

Specifies the DI register contents at the time the error occurred.

errDS

Specifies the DS register contents at the time the error occurred.

errES

Specifies the ES register content at the time the error occurred.

errReserved

Reserved.

errUID

Identifies the computer, for errors that occur on remote computers. If this field is zero, the error occurred on the local computer.

errPID

Identifies the program, for errors that occur on remote computers. If this field is zero, the error occurred in a program on the local computer.

See Also

Interrupt 21h Function 5D0Ah Set Extended Error