WinApi Функция GetDiskFreeSpaceEx

Описание:
function GetDiskFreeSpaceEx(lpDirectoryName: PChar;
var lpFreeBytesAvailableToCaller, lpTotalNumberOfBytes, lpTotalNumberOfFreeBytes: PLargeInteger): BOOL;

Функция получает информацию о дисковом пространстве доступного на накопителе: общий объем пространства, общий объем свободного пространства, и общий объем свободного пространства пригодного для пользователя связанного с вызовом нитей.

Функция доступна в системах Win95 OSR2 или WinNT и выше.
Используйте функцию GetVersionEx, чтобы определить версию системы.

Параметры:
lpDirectoryName: Строка определяющая путь на нужном диске. Это может быть строка в стандарте UNC.
Если lpDirectoryName nil, функция GetDiskFreeSpaceEx получает информацию о диске, который содержит текущий путь. Имейте В Виду, что lpDirectoryName нет должен определять корневую. папку на диске. Функция принимает любую папку на диске.

lpFreeBytesAvailableToCaller: Указатель на переменную, получающую общее число свободный байтов на диске, которые могут использоваться для ассоцации с вызовом нити\потока.
Если операционная система осуществляет препользовательский квотинг, это значение может быть меньше, чем общее число свободных байтов на диске.

lpTotalNumberOfBytes: Указатель на переменную, получающую общее число байтов на диске.

lpTotalNumberOfFreeBytes: Указатель на переменную, получающую общее число свободный байтов на диске. Этот паметр может быть nil.

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

Замечания
Иметь В Виду, что значения полученные этой функцией, имеют тип ULARGE_INTEGER.
Функция GetDiskFreeSpaceEx позволяет вам избежать сложных вычислений требующихся после вызова функции GetDiskFreeSpace.
Функция имеет аналог из модуля SysUtils поэтому рекомендуется указывать размещение функции (Windows.GetDiskFreeSpaceEx..).

При возникновении трудностей с применением на практике данной функции, напоминаю, что у вас всегда есть возможность воспользоваться так называемой услугой компьютерная помощь, говоря простым языком, просто напишите свою проблему через форму обратной связи и наши специалисты в кратчайшие сроки постараются вам помочь.

Материал взят из:
Русская спpавка по Windows API

Последние из рубрики

• GetDialogBaseUnits
• GetDIBits
• GetDiskFreeSpace