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=en:docs:dos:api:int21::56|56h]],INT 2F/AX=1111h

Note

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