Здравствуйте, уважаемые подписчики. Перед вами очередной выпуск рассылки "WinAPI
на русском".
Сайт рассылки: http://www.bcbdev.ru. Материалы по Win32 API, C++Builder.
Раздел "WinAPI": http://www.bcbdev.ru/winapi.htm
Раздел "C++Builder": http://www.bcbdev.ru/cbuilder.htm
Раздел "Примеры кода": http://www.bcbdev.ru/codesamples.htm
Обновления на сайте
В раздел C++Builder добавилась новая статья "Горизонтальные полосы прокрутки
для списков".
Перевод
Сегодня вашему вниманию представлен перевод функции SHGetDiskFreeSpace.
SHGetDiskFreeSpace
Извлекает информацию о дисковом пространстве для указанного тома.
BOOL SHGetDiskFreeSpace(
LPCTSTR pszVolume,
ULARGE_INTEGER* pqwFreeCaller,
ULARGE_INTEGER* pqwTot,
ULARGE_INTEGER* pqwFree
);
Параметры
pszVolume – завершающаяся нулем строка, задающая задает том, для которого будет
извлекаться информация о размере. Значение строки может быть именем диска, UNC-именем
или путем к папке. Вы не можете использовать NULL для задания текущего диска.
pqwFreeCaller – адрес значения типа ULARGE_INTEGER, которое получает количество
байт, доступных вызывающему на данном томе. Если операционная система реализует
пользовательские квоты, это значение может быть меньше, чем общее количество
свободных байт на данном томе.
pqwTot – адрес значения типа ULARGE_INTEGER, которое получает общий объем тома
в байтах.
pqwFree – адрес значения типа ULARGE_INTEGER, которое получает количество байт
свободного пространства на данном томе.
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль.
Комментарии
Эта функция реализована в версиях оболочки 4.71 и выше. Чтобы сохранить обратную
совместимость с предыдущими версиями оболочки, эта функция не должна использоваться
явно. Вместо этого должны использоваться функции LoadLibrary и GetProcAddress
для получения адреса функции SHGetDiskFreeSpace.
Требования
Минимальная версия DLL: shell32.dll версии 4.71 и выше.
Заголовок: shellapi.h.
Библиотека импорта: shell32.lib.
Минимальные ОС: Windows 2000, Windows NT 4.0 с Internet Explorer 4.0, Windows
98, Windows 95 с Internet Explorer 4.0.
См. также
GetDiskFreeSpace.
хелп по WinAPI: http://www.bcbdev.ru/winapi/win32api.exe
С уважением,
ведущий рассылки
Тарас Сорока.
mailto:tnsoroka@online.ru