Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- DOS 5.0 Ref. - <b>function 56h rename file (rename)</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
Function 56h            Rename File (RENAME)

    Renames or moves a file or directory by changing its directory
    entry.

        Entry   AH    = 56h
                DS:DX = Pointer to an ASCIIZ string containing
                        original path and filename
                ES:DI = Pointer to an ASCIIZ string containing
                        new path and filename

        Return  Nothing
                or
                AX = Error code, if CF is set
                     | 02h File not found
                     | 03h Path not found
                     | 05h Access denied
                     | 11h Not the same device

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

    Open files must be closed before they are moved or renamed with
    this function.

    A program can use this function to move a file or directory by
    specifying different paths in the parameters and keeping the
    filename or directory name the same. This function cannot be used
    to move files or directories from one disk drive to another;
    however both the old and new names must specify the same drive
    either explicitly or by default.

    Wildcard characters cannot be included in the filenames.

See Also: 59h

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