Legacy Document

Inside Macintosh: Files /

Chapter 2 - File Manager / File Manager Reference

Shared Environment Routines / Mounting Volumes

PBGetVolMountInfo

After ascertaining the size of the record needed and allocating storage, you can use the PBGetVolMountInfo function to retrieve a record containing all the information needed to mount the volume, except for passwords. You can later pass this record to the PBVolumeMount function to mount the volume.

FUNCTION PBGetVolMountInfo (paramBlock: ParmBlkPtr): OSErr;

paramBlock

A pointer to a basic File Manager parameter block.

-->	ioCompletion	LongInt	A pointer to a completion routine.
<--	ioResult	OSErr	The function's result code.
-->	ioVRefNum	Integer	A volume specification.
-->	ioBuffer	LongInt	A pointer to mounting information.

DESCRIPTION

The PBGetVolMountInfo function places the mounting information for a specified volume into the buffer pointed to by the ioBuffer field. The mounting information for an AppleShare volume is stored as an AFP mounting record. The length of the buffer is specified by the value pointed to by the ioBuffer field in a previous call to PBGetVolMountInfoSize.

The PBGetVolMountInfo function does not return the user password or volume password in the AFPVolMountInfo record. Your application should solicit
these passwords from the user and fill in the record before attempting to mount the remote volume.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro and routine selector for PBGetVolMountInfo are

Trap macro	Selector
_HFSDispatch	$0040

RESULT CODES

noErr	0	No error
nsvErr	-35	Volume not found
paramErr	-50	Parameter error
extFSErr	-58	External file system error; typically, function is not available for that volume