Legacy Document

Inside Macintosh: Files /

Chapter 2 - File Manager / File Manager Reference

Low-Level Volume Access Routines / Updating Volumes

PBFlushVol

You can use the PBFlushVol function to write the contents of the volume buffer and update information about the volume.

FUNCTION PBFlushVol (paramBlock: ParmBlkPtr; async: Boolean): 
                     OSErr;

paramBlock

A pointer to a basic File Manager 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.

DESCRIPTION

On the volume specified by ioNamePtr or ioVRefNum, the PBFlushVol function writes descriptive information about the volume, the contents of the associated volume buffer, and all access path buffers for the volume (if they've changed since the last time PBFlushVol was called).

Note

The date and time of the last modification to the volume are set when the modification is made, not when the volume is flushed.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro for PBFlushVol is _FlushVol.

RESULT CODES

noErr	0	No error
nsvErr	-35	No such volume
ioErr	-36	I/O error
bdNamErr	-37	Bad volume name
paramErr	-50	No default volume
nsDrvErr	-56	No such drive
extFSErr	-58	External file system