Click above to get retro games delivered to your door ever month!

 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().