![]() |
PBGetVolMountInfoSize |
||||
Header: | Files.h | Carbon status: | Supported | |
Determines how much space to allocate for a volume mounting information structure.
OSErr PBGetVolMountInfoSize ( ParmBlkPtr paramBlock );
A pointer to a basic File Manager parameter block.
A result code.
The relevant fields of the parameter block are:
On input, a pointer to a completion function.
On output, the result code of the function.
On input, a volume specification.
On input, a pointer to storage for the size. The ioBuffer field is a pointer to the size information, which is of type Integer (2 bytes). If PBGetVolMountInfoSize returns noErr, that integer contains the size of the volume mounting information structure.
For a specified volume, the PBGetVolMountInfoSize function provides the size of the structure needed to hold the volumes mounting information.
This function allows your application to record the mounting information for a volume and then to mount the volume later. This programmatic mounting function stores the mounting information in a structure called the AFPVolMountInfo structure. The programmatic mounting functions use the ioParam variant of the ParamBlockRec structure.
In general, it is easier to mount remote volumes by creating and then resolving alias records that describe those volumes. The Alias Manager displays the standard user interface for user authentication when resolving alias records for remote volumes. As a result, this function is primarily of interest for applications that need to mount remote volumes with no user interface or with some custom user interface.
This function executes synchronously. You should not call it at interrupt time.
Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.
© 2000 Apple Computer, Inc. (Last Updated 5/8/2000)