GetDiskFreeSpace
The GetDiskFreeSpace
function retrieves information about the specified disk, including the amount
of free space on the disk.
BOOL
GetDiskFreeSpace(
|
LPCTSTR lpRootPathName, |
// address of root path |
|
LPDWORD lpSectorsPerCluster, |
// address of sectors per cluster |
|
LPDWORD lpBytesPerSector, |
// address of bytes per sector |
|
LPDWORD lpNumberOfFreeClusters, |
// address of number of free clusters |
|
LPDWORD lpTotalNumberOfClusters |
// address of total number of clusters |
|
); |
|
Parameters
lpRootPathName
Points to a
null-terminated string that specifies the root directory of the disk to return
information about. If lpRootPathName is NULL, the function uses the root
of the current directory.
lpSectorsPerCluster
Points to a
variable for the number of sectors per cluster.
lpBytesPerSector
Points to a
variable for the number of bytes per sector.
lpNumberOfFreeClusters
Points to a
variable for the total number of free clusters on the disk.
lpTotalNumberOfClusters
Points to a
variable for the total number of clusters on the disk.
Return Values
If the
function succeeds, the return value is nonzero.
If the
function fails, the return value is zero. To get extended error information,
call GetLastError.
Remarks
Windows
95:
The GetDiskFreeSpace
function returns incorrect values for volumes that are larger than 2 gigabytes.
The function caps the values stored into *lpNumberOfFreeClusters and *lpTotalNumberOfClusters
so as to never report volume sizes that are greater than 2 gigabytes.
Even on
volumes that are smaller than 2 gigabytes, the values stored into *lpSectorsPerCluster,
*lpNumberOfFreeClusters, and *lpTotalNumberOfClusters values may
be incorrect. That is because the operating system manipulates the values so
that computations with them yield the correct volume size.
Windows 95
OSR 2: The GetDiskFreeSpaceEx
function is available on Windows 95 systems beginning with OEM Service Release
2 (OSR 2). The GetDiskFreeSpaceEx function returns correct values for
all volumes, including those that are greater than 2 gigabytes.
See Also