[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
Function 5F02h (95-2)    Get Redirection List Entry                 . DOS 3.1

    Returns information on one entry in the network redirection list.

       On entry:      AH         5Fh
                      AL         02h
                      BX         Index into redirection list
                      DS:SI      Pointer to a 128-byte buffer for local device
                                 name
                      ES:DI      Pointer to a 128-byte buffer for network name

       Returns:       AX         Error code, if CF is set
                      BH         Device status flag
                                     Bit  0 = 0 if device valid
                                              1 if device invalid
                      BL         Device type (3=printer, 4=disk drive)
                      CX         Parameter saved via Function 5F03

       Destroys:      DX and BP are both changed

       Error codes:   1          Network not loaded
                      18         No more files

  --------------------------------------------------------------------------

    Subfunction 02 of Function 5Fh returns an entry in the network
    redirection list. The list itself is created via Subfunction 03.

    To call Subfunction 02, place the index value you wish to inspect in
    BX. The local device name will be returned in a 16-byte area pointed
    to by DS:SI, and its network name will be returned in a 128-byte area
    pointed to by ES:DI. BL returns a device-type code (3 for a printer, 4
    for a disk drive), and CX returns a parameter (specified by means of
    Subfunction 03) associated with the device.

    To list all devices on the network, execute this function repeatedly,
    starting with an index (BX) value of 00h, incrementing BX by 1 until
    AX reports an error code of 18.

See Also: 5F03h 5F04h
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson