Método IEmptyVolumeCacheCallBack::P urgeProgress (emptyvc.h)

Llamado periódicamente por un controlador de limpieza de disco para actualizar el administrador de limpieza de disco en el progreso de una purga de archivos deletables.

Sintaxis

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

Parámetros

[in] dwlSpaceFreed

Tipo: DWORDLONG

Cantidad de espacio en disco, en bytes, que se ha liberado en este punto de la purga. El administrador de limpieza de disco usa este valor para actualizar su barra de progreso.

[in] dwlSpaceToFree

Tipo: DWORDLONG

Cantidad de espacio en disco, en bytes, que permanece libre en este punto de la purga.

[in] dwFlags

Tipo: DWORD

Marca que se puede enviar al administrador de limpieza de disco. Puede tener el siguiente valor:

EVCCBF_LASTNOTIFICATION

Esta marca debe establecerse si el controlador no volverá a llamar a este método. Normalmente se establece cuando la purga está próxima a la finalización.

[in] pcwszStatus

Tipo: LPCWSTR

Reservado.

Valor devuelto

Tipo: HRESULT

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	El controlador debe continuar purgando archivos deletables.
E_ABORT	Este valor se devuelve cuando el usuario hace clic en el botón Cancelar del cuadro de diálogo del administrador de limpieza de disco mientras un examen está en curso. El controlador debe detener la purga de archivos y apagarse.

Comentarios

Normalmente, el método Purge del controlador llama a este método mientras el controlador purga los archivos deletables. Los controladores deben llamar periódicamente a PurgeProgress para mantener al usuario informado del progreso, especialmente si la purga tardará mucho tiempo. Llamar a este método con frecuencia también permite que el controlador se apague rápidamente si un usuario cancela una purga.

Requisitos

Cliente mínimo compatible	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	emptyvc.h
Archivo DLL	Shell32.dll (versión 5.0 o posterior)