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
See also: 59h

56h (86) Rename a File