Método IEmptyVolumeCache::GetSpaceUsed (emptyvc.h)

Solicita la cantidad de espacio en disco que el controlador de limpieza de disco puede liberar.

Sintaxis

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

Parámetros

[out] pdwlSpaceUsed

Tipo: DWORDLONG*

Cantidad de espacio en disco, en bytes, que el controlador puede liberar. Este valor se mostrará en la lista del administrador de limpieza de disco, a la derecha de la casilla del controlador. Para indicar que no sabe cuánto espacio en disco se puede liberar, establezca este parámetro en -1 y "??? Se mostrará MB". Si establece la marca EVCF_DONTSHOWIFZERO cuando se llamó a Initialize , al establecer pdwSpaceUsed en cero se notificará al administrador de limpieza de disco para omitir el controlador de su lista.

[in] picb

Tipo: IEmptyVolumeCacheCallback*

Puntero a la interfaz IEmptyVolumeCacheCallback del administrador de limpieza de disco. Este puntero se puede usar para llamar al método ScanProgress de esa interfaz para informar sobre el progreso de la operación.

Valor devuelto

Tipo: HRESULT

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	Correcto.
S_FALSE	Se produjo un error cuando el controlador intentó calcular la cantidad de espacio en disco que se podría liberar.
E_ABORT	La operación de examen finalizó prematuramente. Este valor suele devolverse cuando una llamada a ScanProgress devuelve E_ABORT. Este valor devuelto indica que el usuario canceló la operación haciendo clic en el botón Cancelar del administrador de limpieza de disco.

Comentarios

Cuando el administrador de limpieza de disco llama a este método, el controlador debe empezar a examinar sus archivos para determinar cuál de ellos se puede eliminar y cuánto espacio en disco se liberará. Los controladores deben llamar periódicamente a IEmptyVolumeCache::ScanProgress para mantener al usuario informado del progreso del examen, especialmente si tardará mucho tiempo. Llamar a este método con frecuencia también permite al controlador determinar si el usuario ha cancelado la operación. Si ScanProgress devuelve E_ABORT, el usuario ha cancelado el examen. El controlador debe detener inmediatamente el examen y devolver E_ABORT.

Solo debe establecer el parámetro pdwSpaceUsed en -1 como último recurso. El controlador tiene un valor limitado para un usuario si no sabe cuánto espacio se liberará.

Requisitos

Requisito	Value
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)