qa.hlp (Table of Contents; Topic list)
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.
Int 21H Function 17H
   Summary  Notes  Back
──────────────────────────────────────────────────────────────────────────────
 
▀ The special file control block has a drive code, filename, and exten-
  sion in the usual position (bytes 0 through 0BH) and a second filename
  starting 6 bytes after the first (offset 11H).
 
▀ The ? wildcard character can be used in the first filename. Every file
  matching the first file specification will be renamed to match the sec-
  ond file specification.
 
▀ If the second file specification contains any ? wildcard characters,
  the corresponding letters in the first filename are left unchanged.
 
▀ The function terminates if the new name to be assigned to a file
  matches that of an existing file.
 
▀ An extended FCB can be used with this function to rename a directory.
 
▀ Int 21H Function 56H, which allows full access to the hierarchical
  directory structure, should be used in preference to this function.
                                    -♦-