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

 UsrVolumeFreeGet()
------------------------------------------------------------------------------
 Purpose:
 Get the volume space available to a user.

 Syntax:
 dwSpace = UsrVolumeFreeGet( iVolumeNum, dwUserID )

 Parameters:
 iVolumeNum The volume number, 0 for the first volume, 1 for the second
            and so on.
 dwUserID   The bindery ID number of the user.

 Returns:
 A numeric value (unsigned long int).

 The CA-Clipper name for this function is:
 UsrVolFreGet()

 Description:
 UsrVolumeFreeGet() returns the number of blocks of available disk space
 a user has on a specified volume. iVolumeNum is the volume number and
 dwUserID is the bindery object ID number of the user.

 Returns a value representing the number of blocks free on the specified
 volume.

 Returns NOVERRLONG if an error occurs.

 Example:
 // To return how many blocks user JULIANNE has available on volume
 // SYS (0):
 dwSpaceAvl = UsrVolumeFreeGet( 0, UsrIDGet( "JULIANNE" ) )
 if ( dwSpaceAvl  != NOVERRLONG )
    ? "User JULIANNE has", dwSpaceAvl, " blocks available on volume 0"
 endif

 Notes:
 The block size is between 4Kb (the normal default) and 16Kb,
 depending on the configuration of the file server. The block size in bytes
 of the specified volume is returned by the function VolBlockSizeGet().