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.
-♦-