WdCopyFilesStatusCallback
복사 작업 중 파일 복사 진행률을 보고하기 위해 호출됩니다.구문
매개 변수
fileProgressCount _In_형식: size_t 마지막 콜백 호출 이후 진행률 업데이트가 있는 파일의 수입니다.
fileUpdates _In_reads_opt_(fileProgressCount)형식: const WdCopyFileProgressInfo* 각 항목이 개별 파일의 진행 정보를 포함하는 WdCopyFileProgressInfo 구조체 배열에 대한 포인터입니다.
fileProgressCount가 0이면 nullptr일 수 있습니다.
copyUpdates _In_형식: const WdCopyOperationSummary* 전체 복사 작업 진행 상황 요약이 포함된 WdCopyOperationSummary 구조체에 대한 포인터입니다.
context _In_opt_
형식: void*
WdCopyStatusCallbacks 구조체에 지정된 사용자 정의 컨텍스트 포인터입니다.
반환 값
형식: HRESULT 복사 작업을 계속하려면S_OK를 반환합니다. 복사를 중단하려면 실패 HRESULT를 반환합니다.
설명
이 콜백은 복사 작업 중 개별 파일의 진행률을 보고하기 위해 WdRemoteCopy에 의해 호출됩니다. 호출 빈도는 WdCopyStatusCallbacks의refreshRateMs 멤버에 의해 제어됩니다.
이 콜백에서 실패한 HRESULT를 반환하면 복사 작업이 중단되고 WdRemoteCopy에서 해당 오류가 반환됩니다.
콜백은 WdRemoteCopy 호출과 동일한 스레드에서 호출됩니다. fileUpdates 배열, copyUpdates 구조체 및 그 내용은 콜백 호출 기간 동안에만 유효합니다.