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.

   ◄Summary►  ◄Notes►  ◄Back►
──────────────────────────────────────────────────────────────────────────────
 
  Description:  Get Redirection List Entry     DOS 3.1 Only
 
  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 to receive                     =1 if not valid
   local device name                     BL=device type
  ES:DI=segment:offset of                   03H if printer
   128-byte buffer to receive               04H if drive
   network name                          CX=stored parameter value
                                         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
                                    -♦-