Legacy Document

Inside Macintosh: Files /

Chapter 2 - File Manager / File Manager Reference

Foreign File System Routines /

PBGetForeignPrivs

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

FUNCTION PBGetForeignPrivs (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 PBGetForeignPrivs function retrieves 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. See "Privilege Information in Foreign File Systems" on page 2-20 for a more complete explanation of access-control privileges.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro and routine selector for PBGetForeignPrivs are

Trap macro	Selector
_HFSDispatch	$0060

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