Legacy Document

Inside Macintosh: Files /

Chapter 2 - File Manager / File Manager Reference

File System Specification Routines / Creating and Deleting Files and Directories

FSpDelete

You can use the FSpDelete function to delete files and directories.

FUNCTION FSpDelete (spec: FSSpec): OSErr;

spec

An FSSpec record specifying the file or directory to delete.

DESCRIPTION

The FSpDelete function removes a file or directory. If the specified target is a file, both forks of the file are deleted. The file ID reference, if any, is removed.

A file must be closed before you can delete it. Similarly, a directory must be empty
before you can delete it. If you attempt to delete an open file or a nonempty directory, FSpDelete returns the result code fBsyErr. FSpDelete also returns the result
code fBsyErr if the directory has an open working directory associated with it.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro and routine selector for FSpDelete are

Trap macro	Selector
_HighLevelHFSDispatch	$0006

RESULT CODES

noErr	0	No error
nsvErr	-35	No such volume
ioErr	-36	I/O error
bdNamErr	-37	Bad filename
fnfErr	-43	File not found
wPrErr	-44	Hardware volume lock
fLckdErr	-45	File is locked
vLckdErr	-46	Software volume lock
fBsyErr	-47	File busy, directory not empty, or working directory control block open
dirNFErr	-120	Directory not found or incomplete pathname
afpAccessDenied	-5000	User does not have the correct access