Legacy Document

Inside Macintosh: Files /

Chapter 2 - File Manager / File Manager Reference

Low-Level Volume Access Routines / Obtaining Volume Information

PBSetVInfo

You can use the PBSetVInfo function to change information about a volume.

FUNCTION PBSetVInfo (paramBlock: HParmBlkPtr; async: Boolean): 
                     OSErr;

paramBlock

A pointer to a basic HFS 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 the volume's name.
-->	ioVRefNum	Integer	A volume specification.
-->	ioVCrDate	LongInt	The date and time of initialization.
-->	ioVLsMod	LongInt	The date and time of last modification.
-->	ioVAtrb	Integer	The volume attributes.
-->	ioVBkUp	LongInt	The date and time of the last backup.
-->	ioVSeqNum	Integer	Used internally.
-->	ioVFndrInfo	ARRAY[1..8] OF LongInt
			Information used by the Finder.

DESCRIPTION

The PBSetVInfo function lets you modify information about volumes. You can specify, in ioNamePtr, a pointer to a new name for the volume. Only bit 15 of ioVAtrb can be changed; setting it locks the volume.

Note

You cannot specify the volume by name; you must use either the
volume reference number, the drive number, or a working directory reference number.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro for PBSetVInfo is _SetVolInfo.

RESULT CODES

noErr	0	No error
nsvErr	-35	No such volume
paramErr	-50	No default volume