Function 5F03h (95-3)    Redirect Device                              DOS 3.1

Redirects I/O from a local printer or disk drive to a device on the
network.

On entry:      AH         5Fh
AL         03h
BL         Device type (3=printer, 4=disk drive)
CX         Saved parameter (all values but 0 are
reserved)
DS:SI      Pointer to an ASCIIZ string containing local
device name
ES:DI      Pointer to an ASCIIZ string containing
network path followed by an ASCIIZ string
containing a password

Returns:       AX         Error code, if CF is set

Error codes:   1          Network not loaded
3          Path not found
5          Access denied
8          Insufficient memory

                                                                          

This function allows you to redirect I/O from a local printer or disk
drive to a network device.  You can also control access to the network
device by means of a password.

Notes:         Call this function with a device type code in BL (3
for a printer or 4 for a disk drive), and a 0 in CX.
DS:SI should point to the name of the device you
wish to redirect, and ES:DI should point to an
ASCIIZ string giving the name of the destination
network. The network name must be followed by a
second ASCIIZ string specifying a password. The
password may be 0 to 8 characters in length; to
specify no password, provide a null ASCIIZ string (a
0 byte).

If the redirected device is a printer, acceptable
names are PRN, LPT1, LPT2, and LPT3. If the
redirected device is a disk drive, the source ASCIIZ
string should consist of a drive letter followed by
a colon.

The source ASCIIZ string may also be null; in this
case, DOS attempts to provide access to the network
name with the specified password.

See also: 5F02h
See also: 5F04h
See also: 59h

5F03h (95-3) Redirect Device >= DOS 3.1