Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- Ralf Brown's Interrupt List (Part 1,2) - int 21 - dos 3+ - get extended error code http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
INT 21 - DOS 3+ - GET EXTENDED ERROR CODE
        AH = 59h
        BX = version code (0000h for DOS 3.x)
Return: AX = extended error code (see below)
        BH = class of error (see below)
        BL = suggested action (see below)
        CH = locus (where error occurred) (see below)
        CL, DX, SI, DI, BP, DS, and ES destroyed
Notes:  functions available under DOS 2.x map the true DOS 3+ error code into
          one supported under DOS 2.x
        you should call this function to retrieve the true error code when an
          FCB or DOS 2.x call returns an error
SeeAlso: AX=5D0Ah,INT 2F/AX=122Dh

Values for extended error code:
        01h function number invalid
        02h file not found
        03h path not found
        04h too many open files (no handles available)
        05h access denied
        06h invalid handle
        07h memory control block destroyed
        08h insufficient memory
        09h memory block address invalid
        0Ah environment invalid (usually >32K in length)
        0Bh format invalid
        0Ch access code invalid
        0Dh data invalid
        0Fh invalid drive
        10h attempted to remove current directory
        11h not same device
        12h no more files
---DOS 3+---
        13h disk write-protected
        14h unknown unit
        15h drive not ready
        16h unknown command
        17h data error (CRC)
        18h bad request structure length
        19h seek error
        1Ah unknown media type (non-DOS disk)
        1Bh sector not found
        1Ch printer out of paper
        1Dh write fault
        1Eh read fault
        1Fh general failure
        20h sharing violation
        21h lock violation
        22h disk change invalid
            ES:DI -> ASCIZ volume label of required disk
        23h FCB unavailable
        24h sharing buffer overflow
        25h reserved
        26h (LANtastic) cannot complete file operation
        27h-31h reserved
        32h network request not supported
        33h remote computer not listening
        34h duplicate name on network
        35h network name not found
        36h network busy
        37h network device no longer exists
        38h network BIOS command limit exceeded
        39h network adapter hardware error
        3Ah incorrect response from network
        3Bh unexpected network error
        3Ch incompatible remote adapter
        3Dh print queue full
        3Eh queue not full
        3Fh not enough space to print file
        40h network name was deleted
        41h network: Access denied
        42h network device type incorrect
        43h network name not found
        44h network name limit exceeded
        45h network BIOS session limit exceeded
        46h temporarily paused
        47h network request not accepted
        48h network print/disk redirection paused
        49h (LANtastic) invalid network version
        4Ah (LANtastic) account expired
        4Bh (LANtastic) password expired
        4Ch (LANtastic) login attempt invalid at this time
        4Dh (LANtastic v3+) disk limit exceeded on network node
        4Eh (LANtastic v3+) not logged in to network node
        4Fh reserved
        50h file exists
        51h reserved
        52h cannot make directory
        53h fail on INT 24h
        54h (DOS 3.3+) too many redirections
        55h (DOS 3.3+) duplicate redirection
        56h (DOS 3.3+) invalid password
        57h (DOS 3.3+) invalid parameter
        58h (DOS 3.3+) network write fault
        59h (LANtastic) function not supported on network
        5Ah (LANtastic) required system component not installed

Values for Error Class:
        01h out of resource (storage space or I/O channels)
        02h temporary situation (file or record lock)
        03h authorization (denied access)
        04h internal (system software bug)
        05h hardware failure
        06h system failure (configuration file missing or incorrect)
        07h application program error
        08h not found
        09h bad format
        0Ah locked
        0Bh media error
        0Ch already exists
        0Dh unknown

Values for Suggested Action:
        01h retry
        02h delayed retry
        03h prompt user to reenter input
        04h abort after cleanup
        05h immediate abort
        06h ignore
        07h retry after user intervention

Values for Error Locus:
        01h unknown or not appropriate
        02h block device (disk error)
        03h network related
        04h serial device (timeout)
        05h memory related

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson