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

Метод IEmptyVolumeCacheCallBack::P urgeProgress (emptyvc.h)

  • Статья

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

Синтаксис

HRESULT PurgeProgress(
  [in] DWORDLONG dwlSpaceFreed,
  [in] DWORDLONG dwlSpaceToFree,
  [in] DWORD     dwFlags,
  [in] LPCWSTR   pcwszStatus
);

Параметры

[in] dwlSpaceFreed

Тип: DWORDLONG

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

[in] dwlSpaceToFree

Тип: DWORDLONG

Объем дискового пространства в байтах, который остается освободить на этом этапе очистки.

[in] dwFlags

Тип: DWORD

Флаг, который можно отправить в диспетчер очистки диска. Он может иметь следующее значение:

EVCCBF_LASTNOTIFICATION

Этот флаг следует установить, если обработчик не будет вызывать этот метод снова. Обычно он устанавливается, когда очистка близка к завершению.

[in] pcwszStatus

Тип: LPCWSTR

Зарезервировано.

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

Тип: HRESULT

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

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

Комментарии

Этот метод обычно вызывается методом Purge обработчика, когда обработчик очищает файлы, которые могут быть удалены. Обработчики должны периодически вызывать PurgeProgress , чтобы информировать пользователя о ходе выполнения, особенно если очистка займет много времени. Частое вызов этого метода также позволяет обработчику быстро завершить работу, если пользователь отменит очистку.

Требования

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