다음을 통해 공유


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 값과 다른 값을 반환합니다.

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

설명

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

IBackgroundCopyError 인터페이스에는 오류의 원인을 확인하는 데 사용하는 정보와 전송 프로세스가 진행될 수 있는지 여부가 포함되어 있습니다. 오류의 원인을 확인한 후 다음 옵션 중 하나를 수행합니다. 작업이 90일 동안 오류 상태로 유지되면(기본 JobInactivityTimeout 그룹 정책) 서비스는 큐에서 작업을 제거하고 클라이언트의 임시 파일을 삭제합니다. 작업 삭제는 성공적으로 업로드된 파일에 영향을 주지 않습니다.

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

예제

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

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows XP
지원되는 최소 서버 Windows Server 2003
대상 플랫폼 Windows
헤더 bits.h
라이브러리 Bits.lib
DLL QmgrPrxy.dll

추가 정보

IBackgroundCopyCallback::JobError

IBackgroundCopyError

IBackgroundCopyJob::GetState