Legacy Document

Inside Macintosh: Files /

Chapter 2 - File Manager / File Manager Reference

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

PBSetCatInfo

You can use the PBSetCatInfo function to modify information about files and directories.

FUNCTION PBSetCatInfo (paramBlock: CInfoPBPtr; async: Boolean): 
                        OSErr;

paramBlock

A pointer to a catalog information parameter block.

async

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

for files

-->	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	The directory ID.
-->	ioFlCrDat	LongInt	The date and time of creation.
-->	ioFlMdDat	LongInt	The date and time of the last modification.
-->	ioFlBkDat	LongInt	The date and time of the last backup.
-->	ioFlXFndrInfo	FXInfo	Additional information used by the Finder.

for directories

-->	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.
-->	ioDrUsrWds	DInfo	Information used by the Finder.
-->	ioDrDirID	LongInt	The directory ID.
-->	ioDrCrDat	LongInt	The date and time of creation.
-->	ioDrMdDat	LongInt	The date and time of the last modification.
-->	ioDrBkDat	LongInt	The date and time of the last backup.
-->	ioDrFndrInfo	DXInfo	Additional information used by the Finder.

DESCRIPTION

The PBSetCatInfo function sets information about a file or directory. When used to set information about a file, it works much as PBHSetFInfo does, but lets you set some additional information.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro and routine selector for PBSetCatInfo are

Trap macro	Selector
_HFSDispatch	$000A

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
fLckdErr	-45	File is locked
vLckdErr	-46	Volume is locked or read-only
paramErr	-50	No default volume
dirNFErr	-120	Directory not found or incomplete pathname
afpAccessDenied	-5000	User does not have the correct access