Compartilhar via

Método IEmptyVolumeCache::P urge (emptyvc.h)

  • Artigo

Notifica o manipulador para começar a excluir seus arquivos desnecessários.

Sintaxe

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

Parâmetros

[in] dwlSpaceToFree

Tipo: DWORDLONG

A quantidade de espaço em disco que o manipulador deve liberar. Se esse parâmetro for definido como -1, o manipulador deverá excluir todos os seus arquivos.

[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 PurgeProgress da interface para relatar o progresso da operação.

Valor retornado

Tipo: HRESULT

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 Êxito.
E_ABORT
 A operação foi encerrada prematuramente. Esse valor geralmente é retornado quando PurgeProgress retorna E_ABORT. Isso normalmente acontece quando o usuário cancela a operação clicando no botão Cancelar do gerenciador de limpeza de disco.

Comentários

Para o Windows 98, o parâmetro dwSpaceToFree é sempre definido como o valor especificado pelo manipulador quando IEmptyVolumeCache::GetSpaceUsed foi chamado.

Em geral, os manipuladores devem ser mantidos simples e excluir todos os seus arquivos quando essa função for chamada. Se houver vantagens significativas de desempenho para excluir apenas uma parte dos arquivos, o manipulador deverá implementar o método ShowProperties . Quando chamado, esse método exibe uma interface do usuário que permite que o usuário selecione os arquivos a serem excluídos.

Requisitos

   
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)