IBackgroundCopyJob::GetError 메서드(bits.h)

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

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

문법

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

매개 변수

[out] ppError

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

반환 값

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

비고

이 작업은 심각한 오류에 대한 오류 상태에 놓이거나 일시적인 오류에 대해 진행되지 않은 시간 제한 기간이 만료된 후(이 기간은 GetNoProgressTimeout 메서드에서 검색됨) 다음 옵션 중 하나를 사용하여 작업이 오류인지 확인합니다.

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

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

업로드-회신 작업의 업로드, 회신 또는 서버 애플리케이션 부분이 실패했는지 확인하려면 IBackgroundCopyError::GetError 메서드를 호출하여 오류가 발생한 컨텍스트 를 검색합니다. 컨텍스트가 BG_ERROR_CONTEXT_REMOTE_APPLICATION 경우 서버 애플리케이션이 실패했습니다. 업로드 또는 회신에 오류가 있으면 컨텍스트가 BG_ERROR_CONTEXT_REMOTE_FILE. BG_JOB_REPLY_PROGRESS 구조체의 BytesTotal 멤버가 BG_SIZE_UNKNOWN 경우 업로드에 실패했습니다. 그렇지 않으면 회신에 실패했습니다.

예시

오류 처리 항목의 예제 코드를 참조하세요.

요구 사항

참고하십시오

IBackgroundCopyCallback::JobError

IBackgroundCopyError

IBackgroundCopyJob::GetState