
Click above to get retro games delivered to your door ever month!
X-Hacker.org- Novlib 3.30 Online Reference - <b> volblockfreeget()</b>
[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
VolBlockFreeGet()
------------------------------------------------------------------------------
Purpose:
Get the blocks available on a volume.
Syntax:
dwBlocks = VolBlockFreeGet( iVolNum )
Parameters:
iVolNum The volume number - 0 for the first volume, 1 for the second etc.
Returns:
A numeric value (unsigned long int).
The CA-Clipper name for this function is:
VolBlkFreGet()
Description:
VolBlockFreeGet() returns the number of blocks available on volume number
iVolNum.
Returns NOVERRLONG if an error occurs.
Example:
// To display the number of blocks available on the first disk volume:
dwAvail = VolBlockFreeGet(0)
if ( dwAvail != NOVERRLONG )
? "There are", dwAvail, "blocks available on volume 0"
endif
Notes:
The block size may be found by calling VolBlockSizeGet().
IMPORTANT: The value returned by VolBlockFreeGet() does NOT include space
taken by files waiting to be purged. Novell's VOLINFO.EXE command line
utility returns the free space of a volume as the actual free space + the
space that would be made available by purging deleted files. This can be
achieved with NOVLIB by adding the result of VolBlockFreeGet() to the
result of VolBlockPurgeGet().
See Also: VolBlockSizeGet() VolBlockPurgeGet() VolBlockMaxGet()
Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson