Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- TASM 2.x / MASM 6.x Assembly Language - <b>function 56h (86) rename a file</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
Function 56h (86)        Rename a File

    Rename a file, move a file to a different directory on the same disk,
    or both.

       On 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

       Returns:       AX         Error code, if CF is set

       Error codes:   2          File not found
                      3          Path not found
                      5          Access denied
                      17         Not the same device

                      Call Function 59h for extended error code information
                      (DOS 3.0 and above).

       Network:       Requires Create access rights.

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

    This function renames a file, moves a file to a different directory on
    the same disk, or both.

       Notes:         If a drive designator is included in the new
                      filename, it must be the same as the one included or
                      implied in the original filename.

                      Wildcard characters cannot be included in the
                      filenames.

See Also: 17h 59h

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