IBackgroundCopyJob::Complete 메서드

  • 아티클

작업을 종료하고 전송된 파일을 클라이언트에 저장합니다.

구문

HRESULT Complete();

매개 변수

이 메서드에는 매개 변수가 없습니다.

반환 값

이 메서드는 다음 HRESULT 값을 반환합니다. 메서드는 전송된 파일의 임시 복사본 이름을 지정된 이름으로 바꾸는 데 관련된 오류를 반환할 수도 있습니다.

반환 코드 설명
S_OK
 모든 파일이 성공적으로 전송되었습니다.
DO_E_INVALID_STATE
 다운로드의 경우 작업 상태를 BG_JOB_STATE_CANCELLED 또는 BG_JOB_STATE_ACKNOWLEDGED 수 없습니다.
업로드의 경우 작업의 상태가 BG_JOB_STATE_TRANSFERRED 합니다.

설명

작업의 상태가 BG_JOB_STATE_TRANSFERRED 경우 모든 파일이 성공적으로 전송되었습니다. 작업 상태를 검사 IBackgroundCopyJob::GetState 메서드를 호출합니다. IBackgroundCopyCallback 인터페이스를 구현하여 모든 파일이 클라이언트로 전송될 때 알림을 받을 수도 있습니다.

배달 최적화는 30일 미만의 작업만 유지합니다. 이전 작업은 모두 제거됩니다. 배달 최적화는 JobInactivityTimeout 그룹 정책 지원하지 않습니다.

다운로드 작업의 경우 전송 프로세스 중에 언제든지 Complete 메서드를 호출할 수 있습니다. 그러나 이 메서드를 호출하기 전에 클라이언트로 성공적으로 전송된 파일만 저장됩니다. 예를 들어 배달 최적화에서 5개 파일 중 세 번째 파일을 처리하는 동안 Complete 메서드를 호출하면 처음 두 개의 파일만 저장됩니다. 전송된 파일을 확인하려면 IBackgroundCopyFile::GetProgress 메서드를 호출하고 BytesTransferred 멤버를 BG_FILE_PROGRESS 구조체의 BytesTotal 멤버와 비교합니다.

업로드 작업의 경우 작업의 상태가 BG_JOB_STATE_TRANSFERRED 경우에만 Complete 메서드를 호출할 수 있습니다.

파일의 소유자는 호출한 사용자입니다. 예를 들어 관리자가 다른 사람의 작업을 완료하는 경우 작업 소유자가 아닌 관리자가 파일을 소유합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows 10 버전 1709 [데스크톱 앱만 해당]
지원되는 최소 서버
 Windows Server 버전 1709 [데스크톱 앱만 해당]
헤더
Deliveryoptimization.h
IDL
DeliveryOptimization.idl
라이브러리
Dosvc.lib
DLL
Dosvc.dll
IID
 IID_IBackgroundCopyJob 37668D37-507E-4160-9316-26306D150B12로 정의됩니다.

추가 정보

IBackgroundCopyJob

IBackgroundCopyJob::Cancel

IBackgroundCopyJob::GetState