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 값과 다른 값을 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
오류 개체를 성공적으로 생성했습니다. |
|
오류 인터페이스는 오류가 발생한 후(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 [데스크톱 앱만 해당] |
| 헤더 |
|
| IDL |
|
| 라이브러리 |
|
| DLL |
|
| IID |
IID_IBackgroundCopyJob 37668D37-507E-4160-9316-26306D150B12로 정의됩니다. |