IBackgroundCopyCallback::JobError 메서드
배달 최적화는 작업 상태가 BG_JOB_STATE_ERROR 변경되면 JobError 메서드의 구현을 호출합니다.
구문
HRESULT JobError(
[in] IBackgroundCopyJob *pJob,
[in] IBackgroundCopyError *pError
);
매개 변수
-
pJob [in]
-
오류가 발생하기 전에 전송된 바이트 및 파일 수와 같은 작업 관련 정보를 포함합니다. 또한 작업을 다시 시작하고 취소하는 메서드도 포함되어 있습니다. pJob을 해제하지 마세요. 배달 최적화는 JobError 메서드가 반환될 때 인터페이스를 해제합니다.
-
pError [in]
-
치명적인 오류가 발생했을 때 처리되는 파일 및 오류에 대한 설명과 같은 오류 정보를 포함합니다. pError를 해제하지 마세요. 배달 최적화는 JobError 메서드가 반환될 때 인터페이스를 해제합니다.
반환 값
이 메서드는 S_OK 반환해야 합니다. 그렇지 않으면 배달 최적화는 S_OK 반환될 때까지 이 메서드를 계속 호출합니다. 성능상의 이유로 S_OK 이외의 값을 반환하는 횟수를 몇 번으로 제한해야 합니다. 오류 코드를 반환하는 대신 항상 S_OK 반환하고 내부적으로 오류를 처리하는 것이 좋습니다. 이 메서드가 호출되는 간격은 임의입니다.
설명
오류의 원인을 확인한 후 다음 옵션 중 하나를 수행합니다.
- 작업을 취소하려면 IBackgroundCopyJob::Cancel 메서드를 호출합니다.
- 오류가 발생하기 전에 성공적으로 전송된 작업의 일부를 수락하려면 IBackgroundCopyJob::Complete 메서드를 호출합니다. 이 옵션은 업로드 작업에는 적용되지 않습니다. 업로드 작업의 일부를 완료할 수 없습니다.
- 작업 처리를 완료하려면 문제를 해결한 다음 IBackgroundCopyJob::Resume 메서드를 호출합니다.
일시적인 오류는 JobError 메서드에 대한 호출을 생성하지 않습니다.
배달 최적화는 작업이 HTTP 403 오류에 도달하면 BG_ERROR_CONTEXT_REMOTE_FILE 반환하고, 그렇지 않으면 BG_ERROR_CONTEXT_NONE 반환합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows 10 버전 1709 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 버전 1709 [데스크톱 앱만 해당] |
| 헤더 |
|
| IDL |
|
| 라이브러리 |
|
| DLL |
|
| IID |
IID_IBackgroundCopyCallback 97EA99C7-0186-4AD4-8DF9-C5B4E0ED6B22로 정의됩니다. |