Windows API Guide: FILTERKEYS Structure

Declare Function GetDiskFreeSpace Lib "kernel32.dll" Alias "GetDiskFreeSpaceA" (ByVal lpRootPathName As String, lpSectorsPerCluster As Long, lpBytesPerSector As Long, lpNumberOfFreeClusters As Long, lpTotalNumberOfClusters As Long) As Long

Platforms

Windows 95: Supported but Obsolete with OEM Service Release 2 (OEM2) or later; use GetDiskFreeSpaceEx instead.
Windows 98: Supported but Obsolete; use GetDiskFreeSpaceEx instead.
Windows NT: Requires Windows NT 3.1 or later but obsolete in Windows NT 4.0 or later; use GetDiskFreeSpaceEx instead.
Windows 2000: Supported but Obsolete; use GetDiskFreeSpaceEx instead.
Windows CE: Not Supported.

Description & Usage

GetDiskFreeSpace retrives information about the amount of space on a disk. This information includes the number of sectors in each cluster, the number of bytes in each sector, the number of free clusters, and the total number of clusters. Due to the limitations of the 32-bit integer data type, this function only works properly with disks with a capacity less than 2 MB. The replacement function GetDiskFreeSpaceEx does not have this limitation.

Return Value

If an error occured, the function returns 0 (use GetLastError to determine the error code). If successful, the function returns a non-zero value.

Visual Basic-Specific Issues

None

Parameters

lpRootPathName: The root directory of the disk to get information on, such as "c:\" or "a:\"
lpSectorsPerCluster: 32-bit integer variable which receives the number of sectors in a cluster on the disk.
lpBytesPerSector: 32-bit integer variable which receives the number of bytes in a sector on the disk.
lpNumberOfFreeClusters: 32-bit integer variable which receives the number of unused, empty clusters on the disk. Windows 2000: This may be lower than the actual value if per-user quotas are enabled.
lpTotalNumberOfClusters: 32-bit integer variable which receives the total number of clusters, used and unused, on the disk. Windows 2000: This may be lower than the actual value if per-user quotas are enabled.

Example

' This code is licensed according to the terms and conditions listed here. ' Calculate and display the free and total space on drive C: Dim secPerClus As Long  ' receives sectors per cluster Dim bytePerSec As Long  ' receives bytes per sector Dim freeClus As Long  ' receives number of free clusters Dim totalClus As Long  ' receives total number of clusters Dim retval As Long  ' return value ' Read the information into the variables retval = GetDiskFreeSpace("c:\", secPerClus, bytePerSec, freeClus, totalClus) ' Display the information Debug.Print "Free space:"; freeClus * secPerClus * bytePerSec; "bytes" Debug.Print "Total space:"; totalClus * secPerClus * bytePerSec; "bytes"