On-line справка по Win32 API

БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!

A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать

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

GetDiskFreeSpaceEx, GetDriveType

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Пригласи друзей и счет твоего мобильника всегда будет положительным!

GetDiskFreeSpace

Функция GetDiskFreeSpace извлекает информацию об определенном диске, включая сумму свободного пространства на диске.

BOOL GetDiskFreeSpace(

LPCTSTR lpRootPathName, // АДРЕС корневого пути LPDWORD lpSectorsPerCluster, // адреса секторов за кластерный lpBytesPerSector LPDWORD, // адрес байтов за сектор LPDWORD lpNumberOfFreeClusters, // адрес количества свободного адреса групп LPDWORD lpTotalNumberOfClusters // общего числа групп
);

Параметры

lpRootPathName

Точки на недействительный расторгнутую строку, которые определяют корневой директорий диска, чтобы возвращать информацию о. Если lpRootPathName НЕДЕЙСТВИТЕЛЕН, функция использует корень текущего директория.

lpSectorsPerCluster

Точки на переменную для количества секторов за группу.

lpBytesPerSector

Точки на переменную для количества байтов за сектор.

lpNumberOfFreeClusters

Точки на переменную для общего числа свободных групп на диске.

lpTotalNumberOfClusters

Точки на переменную для общего числа групп на диске.

Обратные Величины

Если функция добивается успеха, обратная величина ненулевая.
Если функция терпит неудачу, обратная величина нулевая. Для того, чтобы расширять информацию ошибки, назовите GetLastError.

Замечания

Windows 95:

Функция GetDiskFreeSpace возвращает неправильные величины для объемов, которые большие чем 2 гигабайта. Функция закрывает величины загруженные в * lpNumberOfFreeClusters и *lpTotalNumberOfClusters с тем, чтобы, чтобы никогда не сообщать размеры объема, которые больше, чем 2 гигабайта.
Даже в объемах, которые меньшие чем 2 гигабайта, величины загружали в *lpSectorsPerCluster, *lpNumberOfFreeClusters, и *lpTotalNumberOfClusters оценивает может быть неправильным. Это - поскольку операционная система манипулирует величинами чтобы вычисления с ими давали правильный размер объема.

Windows 95 OSR 2: функция GetDiskFreeSpaceEx доступна в системах Windows 95, начинаемых с Версии Услуги OEM 2 (OSR 2). Функция GetDiskFreeSpaceEx возвращает правильные величины для всех объемов, включая те которые больше, чем 2 гигабайта.

Смотри Также

GetDiskFreeSpaceEx, GetDriveType

Используются технологии uCoz