Legacy Document

Inside Macintosh: Files /

Chapter 2 - File Manager / File Manager Reference

Low-Level Volume Access Routines / Mounting and Unmounting Volumes

PBUnmountVol

You can use the PBUnmountVol function to unmount a volume.

FUNCTION PBUnmountVol (paramBlock: ParmBlkPtr): OSErr;

paramBlock

A pointer to a basic File Manager parameter block.

<--	ioResult	OSErr	The result code of the function.
-->	ioNamePtr	StringPtr	A pointer to a pathname.
-->	ioVRefNum	Integer	A volume reference number, a working directory reference number, or 0 for the default volume.

DESCRIPTION

The PBUnmountVol function unmounts the specified volume. All user files on the volume must be closed. Then, PBUnmountVol calls PBFlushVol to flush the volume and releases the memory used for the volume.

The PBUnmountVol function always executes synchronously.

WARNING

Don't unmount the startup volume. Doing so will cause a
system crash.

Note

Unmounting a volume does not close working directories; to release the memory allocated to a working directory, call PBCloseWD.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro for PBUnmountVol is _UnmountVol.

RESULT CODES

noErr	0	No error
nsvErr	-35	No such volume
ioErr	-36	I/O error
bdNamErr	-37	Bad volume name
fBsyErr	-47	One or more files are open
paramErr	-50	No default volume
nsDrvErr	-56	No such drive
extFSErr	-58	External file system