삭제 가능한 파일 제거 진행 시 디스크 정리 관리자를 업데이트하기 위해 디스크 정리 처리기에 의해 주기적으로 호출됩니다.
구문
HRESULT PurgeProgress(
[in] DWORDLONG dwlSpaceFreed,
[in] DWORDLONG dwlSpaceToFree,
[in] DWORD dwFlags,
[in] LPCWSTR pcwszStatus
);
매개 변수
[in] dwlSpaceFreed
형식: DWORDLONG
제거의 이 시점에서 해제된 디스크 공간(바이트)입니다. 디스크 정리 관리자는 이 값을 사용하여 진행률 표시줄을 업데이트합니다.
[in] dwlSpaceToFree
형식: DWORDLONG
제거의 이 시점에서 해제해야 하는 디스크 공간의 양(바이트)입니다.
[in] dwFlags
형식:DWORD
디스크 정리 관리자로 보낼 수 있는 플래그입니다. 다음과 같은 값을 가질 수 있습니다.
EVCCBF_LASTNOTIFICATION
처리기가 이 메서드를 다시 호출하지 않을 경우 이 플래그를 설정해야 합니다. 일반적으로 제거가 거의 완료될 때 설정됩니다.
[in] pcwszStatus
형식: LPCWSTR
예약되어 있습니다.
반환 값
형식: HRESULT
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
| 반환 코드 | Description |
|---|---|
|
처리기는 삭제 가능한 파일을 계속 제거해야 합니다. |
|
이 값은 스캔이 진행되는 동안 사용자가 디스크 정리 관리자 대화 상자에서 취소 단추를 클릭하면 반환됩니다. 처리기는 파일 제거를 중지하고 종료해야 합니다. |
설명
이 메서드는 일반적으로 처리기가 삭제 가능한 파일을 제거하는 동안 처리기의 Purge 메서드에 의해 호출됩니다. 처리기는 특히 제거에 시간이 오래 걸리는 경우 사용자에게 진행 상황을 알리기 위해 주기적으로 PurgeProgress 를 호출해야 합니다. 이 메서드를 자주 호출하면 사용자가 제거를 취소하는 경우 처리기가 즉시 종료됩니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional, Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | emptyvc.h |
| DLL | Shell32.dll(버전 5.0 이상) |