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