Legacy Document

Inside Macintosh: Files /

Chapter 2 - File Manager / File Manager Reference

Shared Environment Routines / Manipulating Share Points

PBShare

You can use the PBShare function to establish a local volume or directory as a
share point.

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

paramBlock

A pointer to a basic 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.
-->	ioDirID	LongInt	A directory ID.

DESCRIPTION

The PBShare function makes the directory specified by the ioNamePtr and ioDirID fields a share point. If ioNamePtr is NIL, then ioDirID is the directory ID of the directory that is to become a share point. If ioNamePtr points to a partial pathname, ioDirID is the parent directory of the directory to be shared. The ioVRefNum field can contain a volume reference number, a working directory reference number, a drive number, or 0 for the default volume.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro and routine selector for PBShare are

Trap macro	Selector
_HFSDispatch	$0042

RESULT CODES

noErr	0	No error
tmfoErr	-42	Too many share points
fnfErr	-43	File not found
dupFNErr	-48	Already a share point with this name
paramErr	-50	Function not supported by volume
dirNFErr	-120	Directory not found
afpAccessDenied	-5000	This directory cannot be shared
afpObjectTypeErr	-5025	Object was a file, not a directory
afpContainsSharedErr	-5033	The directory contains a share point
afpInsideSharedErr	-5043	The directory is inside a shared directory