Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- Programmers Reference 0.02b - <b>function 17h (23) rename file, using fcbs</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
Function 17h (23)        Rename File, using FCBs

    Changes all matching occurrences of the first filename in the current
    directory to the second filename.

       On entry:      AH         17h
                      DS:DX      Pointer to an FCB that has been modified to
                                 contain two filenames.

       Returns:       AL         00h       If operation is successful
                                 FFh       If operation is unsuccessful

       Network:       Requires Create access rights

  --------------------------------------------------------------------------

    This function renames files via a modified FCB that contains the drive
    code and original filename in their usual positions, and has a new
    filename beginning six bytes after the original filename (at offset
    11h in the FCB).

       Notes:         The '?' wildcard character may appear in either the
                      first filename or the second filename. A '?'
                      character in the first filename has the conventional
                      meaning: it is used to find files that match this
                      filespec.

                      A '?' in the second filename has a different effect:
                      It means don't change the corresponding character in
                      matching filenames.

                      This function will not rename a file to that of an
                      already existing filename; in that event, the
                      function will terminate, returning FFh in AL.

                      Read-only files are not renamed by this function.

See Also: 56h FCB

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson