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

 VolBlkFreGet()
------------------------------------------------------------------------------
 Purpose:
 Get the blocks available on a volume.

 Syntax:
 dwBlocks = VolBlkFreGet( iVolNum )

 Parameters:
 iVolNum The volume number - 0 for the first volume, 1 for the second etc.

 Returns:
 A numeric value (unsigned long int).

 Description:
 VolBlkFreGet() 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 = VolBlkFreGet(0)
 if ( dwAvail != NOVERRLONG )
    ? "There are", dwAvail, "blocks available on volume 0"
 endif

 Notes:
 The block size may be found by calling VolBlkSizGet().

 IMPORTANT: The value returned by VolBlkFreGet() 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 VolBlkFreGet() to the
 result of VolBlkPurGet().