Table of Contents
Note: This API call is for DOS personality only. Use Family API for portability.
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
Text based on Ralf Brown Interrupt List Release 61
DOS API | |
---|---|
Process manager | INT 20H, INT 21H: 00H, 25H, 26H, 31H, 34H, 35H, 4CH, INT 22H, INT 27H, INT 28H |
File manager | INT 25H, INT 26H, INT 21H: 0DH, 0EH, 0FH, 10H, 11H, 12H, 13H, 14H, 15H, 16H, 17H, 19H, 1AH, 1BH, 1CH, 21H, 22H, 23H, 24H, 27H, 28H, 29H, 2EH, 2FH, 32H, 3305H, 36H, 39H, 3AH, 3BH |
Character Device I/O | INT 29H, INT 21H: 01H, 02H, 03H, 04H, 05H, 06H, 07H, 08H, 09H, 0AH, 0BH, 0AH, 0CH |
Signals | INT 23H, INT 24H, INT 21H: 3300H, 3301H, 3302H |
Memory manager | |
Date and Time | INT 21H: 2AH, 2BH, 2CH, 2DH |
Misc | INT 21H: 30H, 3306H, 3700H, 3701H, 3702H, 3703H |
NLS | INT 21H: 3303H, 3304H, 3800H, 3801H |