Legacy Document

Inside Macintosh: Files /

Chapter 2 - File Manager / File Manager Reference

Shared Environment Routines / Controlling Directory Access

PBHSetDirAccess

You can use the PBHSetDirAccess function to change the access control information for a directory.

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

paramBlock

A pointer to an 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.
-->	ioACOwnerID	LongInt	The owner ID.
-->	ioACGroupID	LongInt	The group ID.
-->	ioACAccess	LongInt	The access rights.
-->	ioDirID	LongInt	The directory ID.

DESCRIPTION

The PBHSetDirAccess function allows you to change the access rights to the specified directory. The ioACAccess field contains the directory's access rights. You cannot set the owner or user rights bits of the ioACAccess field directly (if you try to do this, PBHSetDirAccess returns the result code paramErr). See "Directory Access Privileges," beginning on page 2-18, for a description of the ioACAccess field.

To change the owner or group, you should set the ioACOwnerID or ioACGroupID field to the appropriate ID. You must be the owner of the directory to change the owner or group ID. A guest on a server can manipulate the privileges of any directory owned by the guest.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro and routine selector for PBHSetDirAccess are

Trap macro	Selector
_HFSDispatch	$0033

RESULT CODES

noErr	0	No error
fnfErr	-43	Directory not found
vLckdErr	-46	Volume is locked or read-only
paramErr	-50	Parameter error
afpAccessDenied	-5000	User does not have the correct access to the directory
afpObjectTypeErr	-5025	Object is a file, not a directory