Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

 ◄Detail► ◄Example►                          ◄Up► ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
 
  Interrupt:   21h     Function:   56h
 
  Title:       Rename File
 
  See also:    @MoveFile
 
  Description:
 
     Renames a file and/or moves its directory entry to a different
     directory on the same disk. In MS-DOS versions 3.0 and later, this
     function can also be used to rename a directory.
 
     Input                                Output
 
     AH = 56h                             If function successful
     DS:DX = segment:offset of              Carry flag: clear
             current ASCIIZ path name
     ES:DI = segment:offset of new        If function unsuccessful
             ASCIIZ path name               Carry flag: set
                                            AX = Error code (02h, 03h,
                                                 05h, or 11h)
                                            See: ◄Error codes►
                                    -♦-