Legacy Document

Inside Macintosh: Files /

Chapter 2 - File Manager / File Manager Reference

Foreign File System Routines /

PBSetForeignPrivs

You can use the PBSetForeignPrivs function to change the native access-control information for a file or directory stored on a volume managed by a foreign file system.

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

paramBlock

A pointer to a foreignPrivParam variant of the 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 file or directory name.
-->	ioVRefNum	Integer	A volume specification.
-->	ioForeignPrivBuffer	Ptr	A pointer to the privilege information buffer.
-->	ioForeignPrivReqCount	LongInt	The size allocated for the buffer.
-->	ioForeignPrivActCount	LongInt	The amount used in buffer.
-->	ioForeignPrivDirID	Integer	The parent directory ID.
-->	ioForeignPrivInfo1	LongInt	Information specific to privilege model.
-->	ioForeignPrivInfo2	LongInt	Information specific to privilege model.
-->	ioForeignPrivInfo3	LongInt	Information specific to privilege model.
-->	ioForeignPrivInfo4	LongInt	Information specific to privilege model.

DESCRIPTION

The PBSetForeignPrivs function modifies access information for a file or directory on a volume managed by a file system that uses a privilege model different from the
AFP model.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro and routine selector for PBSetForeignPrivs are

Trap macro	Selector
_HFSDispatch	$0061

RESULT CODES

noErr	0	No error
nsvErr	-35	Volume not found
paramErr	-50	Volume is HFS or MFS (that is, it has no foreign privilege model), or foreign volume does not support these calls