Legacy Documentclose button

Important: The information in this document is obsolete and should not be used for new development.

Previous Book Contents Book Index Next

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.
-->ioCompletionProcPtrA pointer to a completion routine.
<--ioResultOSErrThe result code of the function.
-->ioNamePtrStringPtrA pointer to a pathname.
-->ioVRefNumIntegerA 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
noErr0No error
nsvErr-35No such volume
ioErr-36I/O error
bdNamErr-37Bad volume name
paramErr-50No default volume
nsDrvErr-56No such drive
extFSErr-58External file system

Previous Book Contents Book Index Next

© Apple Computer, Inc.
2 JUL 1996