Assembly Language Help (alang.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.
Int 21h Function 5Fh Subfunction 02h
 Detail                                    Up Contents Index Back
────────────────────────────────────────────────────────────────────────────
 
  Interrupt:   21h     Function:   5Fh     Subfunction:   02h
 
  Title:       Get Redirection List Entry [Version 3.1+]
 
  Description:
 
     Allows inspection of the system redirection list, which associates
     local logical names with network files, directories, or printers.
     This function call is only available when Microsoft Networks is
     running and the file-sharing module (SHARE.EXE) has been loaded.
 
     Input                             Output
 
     AH = 5Fh                          If function successful
     AL = 02h                            Carry flag: clear
     BX = Redirection list index         BH = Device status flag
     DS:SI = segment:offset of                Bit 0 = 0 (if device valid)
             16-byte buffer                         = 1 (if not valid)
             to receive local            BL = Device type
             device name                    = 03h (if printer)
     ES:DI = segment:offset of              = 04h (if drive)
             128-byte buffer to          CX = Stored parameter value
             receive network name        DX = Destroyed
                                         BP = Destroyed
                                         DS:SI = segment:offset of ASCIIZ
                                                 local device name
                                         ES:DI = segment:offset of ASCIIZ
                                                 network name
 
                                         If function unsuccessful
                                           Carry flag: set
                                           AX = Error code (01h or 12h)
                                           See: Error codes
                                    -♦-