IBackgroundCopyJob::GetError 메서드

오류가 발생한 후 오류 인터페이스를 검색합니다.

배달 최적화는 작업 상태가 BG_JOB_STATE_ERROR 또는 BG_JOB_STATE_TRANSIENT_ERROR 때 오류 개체를 생성합니다. IBackgroundCopyXXXX 인터페이스 메서드에 대한 호출이 실패하면 서비스에서 오류 개체를 만들지 않습니다. 오류 개체는 배달 최적화가 작업에 대한 데이터 전송(작업 상태가 BG_JOB_STATE_TRANSFERRING 변경됨)을 시작하거나 애플리케이션이 종료될 때까지 사용할 수 있습니다.

구문

HRESULT GetError(
  [out] IBackgroundCopyError **ppError
);

매개 변수

ppError [out]

오류 코드, 오류에 대한 설명 및 오류가 발생한 컨텍스트를 제공하는 오류 인터페이스입니다. 또한 이 매개 변수는 오류가 발생했을 때 전송되는 파일을 식별합니다. 완료되면 ppError를 릴리스합니다.

반환 값

이 메서드는 다음 HRESULT 값과 다른 값을 반환합니다.

반환 코드	설명
S_OK	오류 개체를 성공적으로 생성했습니다.
DO_E_ERROR_INFORMATION_UNAVAILABLE	오류 인터페이스는 오류가 발생한 후(BG_JOB_STATE_ERROR 또는 BG_JOB_STATE_TRANSIENT_ERROR) 배달 최적화가 데이터 전송(BG_JOB_STATE_TRANSFERRING)을 시작하기 전에만 사용할 수 있습니다.

설명

이 작업은 심각한 오류에 대한 오류 상태에 놓입니다. 다음 옵션 중 하나를 사용하여 작업이 오류인지 확인합니다.

• 작업의 상태를 폴링하려면 IBackgroundCopyJob::GetState 메서드를 호출합니다. 상태가 BG_JOB_STATE_ERROR 경우 작업이 잘못되었습니다.
• 오류가 발생할 때 알림을 받으려면 IBackgroundCopyCallback 인터페이스(특히 JobError 메서드)를 구현합니다. 그런 다음 , IBackgroundCopyJob::SetNotifyInterface 메서드를 호출하여 콜백을 등록하고 IBackgroundCopyJob::SetNotifyFlags 메서드를 호출하여 BG_NOTIFY_JOB_ERROR 플래그를 설정합니다.

IBackgroundCopyError 인터페이스에는 오류의 원인을 확인하는 데 사용하는 정보와 전송 프로세스가 진행될 수 있는지 여부가 포함되어 있습니다. 오류의 원인을 확인한 후 다음 옵션 중 하나를 수행합니다.

• 작업을 취소하려면 IBackgroundCopyJob::Cancel 메서드를 호출합니다.
• 오류가 발생하기 전에 성공적으로 전송된 파일을 저장하려면 IBackgroundCopyJob::Complete 메서드를 호출합니다.
• 작업 처리를 완료하려면 문제를 해결한 다음 IBackgroundCopyJob::Resume 메서드를 호출합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	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

IBackgroundCopyCallback::JobError

IBackgroundCopyError

IBackgroundCopyJob::GetState