Legacy Document

Inside Macintosh: Files /

Chapter 2 - File Manager / File Manager Reference

Low-Level HFS Routines / Accessing Information About Files and Directories

PBHSetFInfo

You can use the PBHSetFInfo function to set information for a file.

FUNCTION PBHSetFInfo (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.
-->	ioFlFndrInfo	FInfo	Information used by the Finder.
-->	ioDirID	LongInt	A directory ID.
-->	ioFlCrDat	LongInt	The date and time of creation.
-->	ioFlMdDat	LongInt	The date and time of last modification.

DESCRIPTION

The PBHSetFInfo function sets information (including the date and time of creation and modification, and information needed by the Finder) about the file having the name pointed to by ioNamePtr on the volume specified by ioVRefNum. You should call PBHGetFInfo just before PBHSetFInfo, so that the current information is present in the parameter block.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro for PBHSetFInfo is _HSetFileInfo.

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
dirNFErr	-120	Directory not found or incomplete pathname
afpAccessDenied	-5000	User does not have the correct access
afpObjectTypeErr	-5025	Object was a directory