PBVolumeMount

Mount a volume

#include <Files.h> File Manager

ParmBlkPtr pb ; address of an ParamBlockRec record

returns Error Code; 0=no error

You use the PBVolumeMount function to mount a volume, using either the

information returned by the PBGetVolMountInfo function or a structure

you filled in yourself.

pb is the address of an IOParam structure. The relevant fields are as

follows:

Æ ioCompletion ProcPtr 4 12 Completion routine address (if async =TRUE)

¨ ioResult short 2 16 Error Code (0=no error, 1=not done yet)

¨ ioVRefNum short 2 22 Volume or working directory reference

Æ ioBuffer Ptr 4 32 Pointer to mounting information

Returns: an operating system Error Code. It will be one of:

noErr (0) No error

notOpenErr -28 AppleTalk is not open

nsvErr (-35) Volume not found

paramErr (-50) Parameter error; typically, zone, server, and

volume name combination is not valid or not

complete, or the user name is not recognized

extFSErr (-58) External file system error; typically, file system

signature was not recognized, or function is not

available for that volume

memFullErr (-108) Not enough memory to create a new volume control

block for mounting the volume

afpBadUAM (-5002) User authentication method is unknown

afpBadVersNum (-5003) Workstation is using an AFP version that the server

doesn't recognize

afpNoServer (-5016) Server is not responding

afpUserNotAuth (-5023) User authentication failed (usually, password is not

correct)

afpPwdExpiredErr (-5042) Password has expired on server

Notes: The PBVolumeMount function mounts a volume and returns its volume

reference number. If you're mounting an AppleShare volume, place the

volume's AFP mounting record in the buffer pointed to by the ioBuffer field.

Because the password fields are not included in an AFP mounting record

returned by PBGetVolMountInfo, you must set these fields before calling

Referenced by (6):