Compartilhar via

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

  • Artigo

Chamado periodicamente por um manipulador de limpeza de disco para atualizar o gerenciador de limpeza de disco sobre o progresso de uma limpeza de arquivos deletáveis.

Sintaxe

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

Parâmetros

[in] dwlSpaceFreed

Tipo: DWORDLONG

A quantidade de espaço em disco, em bytes, que foi liberada neste ponto na limpeza. O gerenciador de limpeza de disco usa esse valor para atualizar sua barra de progresso.

[in] dwlSpaceToFree

Tipo: DWORDLONG

A quantidade de espaço em disco, em bytes, que permanece a ser liberada neste ponto na limpeza.

[in] dwFlags

Tipo: DWORD

Um sinalizador que pode ser enviado para o gerenciador de limpeza de disco. Ele pode ter o seguinte valor:

EVCCBF_LASTNOTIFICATION

Esse sinalizador deverá ser definido se o manipulador não chamar esse método novamente. Normalmente, ele é definido quando a limpeza está perto da conclusão.

[in] pcwszStatus

Tipo: LPCWSTR

Reservado.

Retornar valor

Tipo: HRESULT

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 O manipulador deve continuar limpando arquivos deletáveis.
E_ABORT
 Esse valor é retornado quando o usuário clica no botão Cancelar na caixa de diálogo do gerenciador de limpeza de disco enquanto uma verificação está em andamento. O manipulador deve parar de limpar arquivos e desligar.

Comentários

Esse método normalmente é chamado pelo método Purge do manipulador enquanto o manipulador está limpando arquivos deletáveis. Os manipuladores devem chamar PurgeProgress periodicamente para manter o usuário informado sobre o progresso, especialmente se a limpeza levará muito tempo. Chamar esse método com frequência também permite que o manipulador seja desligado imediatamente se um usuário cancelar uma limpeza.

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)