en:docs:dos:api:int21:17

Note: This API call is for DOS and Win16 personality only. Use Family API for portability.

2018/09/07 05:04 · prokushev · 0 Comments

Int 21H, AH=17H

Version

1 and higher

Brief

RENAME FILE USING FCB

Family API

Input

      AH = 17h
      DS:DX -> modified FCB (see also #01345)
              the old filename ('?' wildcards OK) is in the standard location
              while the new filename ('?' wildcards OK, no drive) is stored
              in the 11 bytes beginning at offset 11h

Return

AL = status

          00h successfully renamed
          FFh no matching files,file is read-only, or new name already exists

Notes

subdirectories may be renamed using an extended FCB with the

        appropriate attribute, as may volume labels
      DR DOS checks password attached with AX=4303h before permitting rename
      

See also

AH=0Fh,AH=13h,AX=4303h,AH=56h,INT 2F/AX=1111h

Note

2018/09/04 17:23 · prokushev · 0 Comments