Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- Programmers Reference 0.02b - <b>function 5f02h (95-2) get redirection list entry . dos 3.1</b> http://www.X-Hacker.org [<<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

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