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

Solicita a quantidade de espaço em disco que o manipulador de limpeza de disco pode liberar.

Sintaxe

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

Parâmetros

[out] pdwlSpaceUsed

Tipo: DWORDLONG*

A quantidade de espaço em disco, em bytes, que o manipulador pode liberar. Esse valor será exibido na lista do gerenciador de limpeza de disco à direita da caixa de marcar do manipulador. Para indicar que você não sabe quanto espaço em disco pode ser liberado, defina esse parâmetro como -1 e "??? MB" será exibido. Se você definir o sinalizador EVCF_DONTSHOWIFZERO quando Initialize foi chamado, definir pdwSpaceUsed como zero notificará o gerenciador de limpeza de disco para omitir o manipulador de sua lista.

[in] picb

Tipo: IEmptyVolumeCacheCallback*

Um ponteiro para a interface IEmptyVolumeCacheCallback do gerenciador de limpeza de disco. Esse ponteiro pode ser usado para chamar o método ScanProgress dessa interface para relatar o progresso da operação.

Retornar valor

Tipo: HRESULT

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	Êxito.
S_FALSE	Ocorreu um erro quando o manipulador tentou calcular a quantidade de espaço em disco que poderia ser liberada.
E_ABORT	A operação de verificação foi encerrada prematuramente. Esse valor geralmente é retornado quando uma chamada para ScanProgress retorna E_ABORT. Esse valor retornado indica que o usuário cancelou a operação clicando no botão Cancelar do gerenciador de limpeza de disco.

Comentários

Quando esse método é chamado pelo gerenciador de limpeza de disco, o manipulador deve começar a examinar seus arquivos para determinar qual deles pode ser excluído e quanto espaço em disco será liberado. Os manipuladores devem chamar IEmptyVolumeCache::ScanProgress periodicamente para manter o usuário informado sobre o progresso da verificação, especialmente se levará muito tempo. Chamar esse método com frequência também permite que o manipulador determine se o usuário cancelou a operação. Se ScanProgress retornar E_ABORT, o usuário cancelou a verificação. O manipulador deve parar imediatamente a verificação e retornar E_ABORT.

Você só deve definir o parâmetro pdwSpaceUsed como -1 como último recurso. O manipulador será de valor limitado a um usuário se ele não souber quanto espaço será liberado.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	emptyvc.h
DLL	Shell32.dll (versão 5.0 ou posterior)