Legacy Document

Inside Macintosh: Files /

Chapter 2 - File Manager / File Manager Reference

Low-Level HFS Routines / Creating and Deleting Files and Directories

PBHCreate

You can use the PBHCreate function to create a new file.

FUNCTION PBHCreate (paramBlock: HParmBlkPtr; async: Boolean): 
                     OSErr;

paramBlock

A pointer to a basic HFS parameter block.

async

A Boolean value that specifies asynchronous (TRUE) or synchronous (FALSE) execution.

-->	ioCompletion	ProcPtr	A pointer to a completion routine.
<--	ioResult	OSErr	The result code of the function.
-->	ioNamePtr	StringPtr	A pointer to a pathname.
-->	ioVRefNum	Integer	A volume specification.
-->	ioDirID	LongInt	A directory ID.

DESCRIPTION

The PBHCreate function creates a new file (both forks); the new file is unlocked and empty. The date and time of its creation and last modification are set to the current date and time. If the file created isn't temporary (that is, if it will exist after the user quits the application), the application should call PBHSetFInfo (after PBHCreate) to fill in the information needed by the Finder.

Files created using PBHCreate are not automatically opened. If you want to write
data to the new file, you must first open the file using a file access routine (such
as PBHOpenDF).

Note

The resource fork of the new file exists but is empty. You'll need to
call one of the Resource Manager procedures CreateResFile, HCreateResFile, or FSpCreateResFile to create a resource map in the file before you can open it (by calling one of the Resource Manager functions OpenResFile, HOpenResFile, or FSpOpenResFile).

ASSEMBLY-LANGUAGE INFORMATION

The trap macro for PBHCreate is _HCreate.

RESULT CODES

noErr	0	No error
dirFulErr	-33	File directory full
dskFulErr	-34	Disk is full
nsvErr	-35	No such volume
ioErr	-36	I/O error
bdNamErr	-37	Bad filename
fnfErr	-43	Directory not found or incomplete pathname
wPrErr	-44	Hardware volume lock
vLckdErr	-46	Software volume lock
dupFNErr	-48	Duplicate filename and version
dirNFErr	-120	Directory not found or incomplete pathname
afpAccessDenied	-5000	User does not have the correct access
afpObjectTypeErr	-5025	A directory exists with that name