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

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

  • Статья

Уведомляет обработчик о начале удаления ненужных файлов.

Синтаксис

HRESULT Purge(
  [in] DWORDLONG                 dwlSpaceToFree,
  [in] IEmptyVolumeCacheCallBack *picb
);

Параметры

[in] dwlSpaceToFree

Тип: DWORDLONG

Объем дискового пространства, который должен освободить обработчик. Если для этого параметра задано значение -1, обработчик должен удалить все свои файлы.

[in] picb

Тип: IEmptyVolumeCacheCallback*

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

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

Тип: HRESULT

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

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

Комментарии

Для Windows 98 параметру dwSpaceToFree всегда присваивается значение, заданное обработчиком при вызове метода IEmptyVolumeCache::GetSpaceUsed .

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

Требования

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