IFileSyncProviderCallback::OnFileCopyProgress
파일이 복사되는 동안 진행률을 표시하기 위해 주기적으로 발생합니다.
HRESULT OnFileCopyProgress(
LPCWSTR pcszNewFilePath,
DWORD dwPercentCopied);
매개 변수
- pcszNewFilePath
[in, string] 복사 중인 파일의 경로입니다. 이 경로는 루트 디렉터리에 상대적입니다.
- dwPercentCopied
[in] 복사 작업의 진행률입니다. 이 값은 백분율로 지정됩니다.
반환 값
- S_OK
주의
이 이벤트는 파일에 기록되는 512KB 블록마다 한 번 발생합니다.
파일이 512KB 미만이면 이 이벤트가 발생하지 않습니다.
이 이벤트는 파일 복사 작업이 완료되었음을 나타내기 위해 발생하지 않습니다. 파일이 복사된 후에는 IFileSyncProviderCallback::OnChangeApplied 이벤트가 대신 발생합니다.
변경 유형이 FILESYNC_CHANGE_TYPE_RENAME이면 pcszNewFilePath에는 이름을 바꾼 이후 업데이트된 파일 경로가 포함됩니다.
OnFileCopyProgress에서 오류를 반환할 경우 Sync Framework에서는 현재 일괄 변경 내용 처리를 중지하고 IFileSyncProvider의 ProcessChangeBatch 메서드에서 오류를 반환합니다.