Поделиться через

Метод IEmptyVolumeCache::GetSpaceUsed (emptyvc.h)

  • Статья

Запрашивает объем дискового пространства, который может освободить обработчик очистки диска.

Синтаксис

HRESULT GetSpaceUsed(
  [out] DWORDLONG                 *pdwlSpaceUsed,
  [in]  IEmptyVolumeCacheCallBack *picb
);

Параметры

[out] pdwlSpaceUsed

Тип: DWORDLONG*

Объем дискового пространства в байтах, который может освободить обработчик. Это значение будет отображаться в списке диспетчера очистки диска справа от поля проверка обработчика. Чтобы указать, что вы не знаете, сколько места на диске можно освободить, задайте для этого параметра значение -1 и "??? Отобразятся МБ". Если при вызове метода Initialize был задан флаг EVCF_DONTSHOWIFZERO, присвоив pdwSpaceUsed значение нулю, диспетчер очистки диска уведомит его о пропуске обработчика из списка.

[in] picb

Тип: IEmptyVolumeCacheCallback*

Указатель на интерфейс IEmptyVolumeCacheCallback диспетчера очистки диска. Этот указатель можно использовать для вызова метода ScanProgress этого интерфейса, чтобы сообщить о ходе выполнения операции.

Возвращаемое значение

Тип: HRESULT

Этот метод может возвращать одно из этих значений.

Код возврата Описание
S_OK
 Успешно.
S_FALSE
 Ошибка при попытке обработчика вычислить объем свободного места на диске.
E_ABORT
 Операция сканирования была завершена преждевременно. Это значение обычно возвращается, когда вызов ScanProgress возвращает E_ABORT. Это возвращаемое значение указывает, что пользователь отменил операцию, нажав кнопку Отмена диспетчера очистки диска.

Комментарии

При вызове этого метода диспетчером очистки диска обработчик должен начать сканирование своих файлов, чтобы определить, какие из них можно удалить и сколько места на диске будет освобождено. Обработчики должны периодически вызывать IEmptyVolumeCache::ScanProgress , чтобы информировать пользователя о ходе сканирования, особенно если это займет много времени. Частое вызов этого метода также позволяет обработчику определить, отменил ли пользователь операцию. Если ScanProgress возвращает E_ABORT, пользователь отменил проверку. Обработчик должен немедленно прекратить сканирование и вернуть E_ABORT.

В качестве последнего средства для параметра pdwSpaceUsed следует задать только значение -1. Обработчик имеет ограниченную ценность для пользователя, если он не знает, сколько пространства будет освобождено.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header emptyvc.h
DLL Shell32.dll (версия 5.0 или более поздняя)