[<<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
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson