Important: The information in this document is obsolete and should not be used for new development.
PBGetForeignPrivs
You can use thePBGetForeignPrivs
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
ThePBGetForeignPrivs
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 forPBGetForeignPrivs
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