Compartilhar via


Método IEmptyVolumeCacheCallBack::ScanProgress (emptyvc.h)

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

Sintaxe

HRESULT ScanProgress(
  [in] DWORDLONG dwlSpaceUsed,
  [in] DWORD     dwFlags,
  [in] LPCWSTR   pcwszStatus
);

Parâmetros

[in] dwlSpaceUsed

Tipo: DWORDLONG

A quantidade de espaço em disco que o manipulador pode liberar neste ponto da verificação.

[in] dwFlags

Tipo: DWORD

Um sinalizador que pode ser enviado para o gerenciador de limpeza de disco. Esse sinalizador pode ter o valor a seguir.

EVCCBF_LASTNOTIFICATION

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

[in] pcwszStatus

Tipo: LPCWSTR

Reservado.

Valor retornado

Tipo: HRESULT

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
O manipulador deve continuar verificando 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 a verificação e desligar.

Comentários

Esse método normalmente é chamado pelo método GetSpaceUsed do manipulador enquanto o manipulador está verificando arquivos deletáveis.

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)