Share via

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